Google Merchants MCP Server

Google Merchant Center MCP

English | Русский

A1 Google Merchant Center MCP connects an AI app to your Google Merchant Center account. Find out why products are disapproved, inspect feeds and promotions, explore reports and market prices, then make deliberate changes to product data when you need to.

It works with the Merchant Center data behind Shopping listings: products, data sources, promotions and reports. Campaigns, budgets and bids belong to Google Ads and are outside this server.

• 22 tools. 15 operations only read Merchant Center data; 5 write product, data-source or promotion data; 2 are potentially destructive.
• Your Google access. The server uses your OAuth credentials and the Merchant API v1 — it does not create a separate Merchant Center account.
• Source-aware changes. Product and promotion inputs can be changed only through an API data source. A file feed can be re-fetched, but its contents are not edited here.
• Visible boundaries. Tools carry read-only, write or destructive metadata, so an AI client can distinguish an inspection from a live change.

Start with a read-only question:

Which products are disapproved, and what issues does Google report for each?

Connect the server · Explore use cases · Open technical documentation

---

See it work in a minute

You: Which products are disapproved, and what issues does Google report for each?

Assistant: Lists the affected products and explains the item-level issues that Merchant Center reports.

You: Show the current price and availability of product SKU-123, then prepare an availability update to in_stock.

Assistant: Shows the current product input, the API data source it belongs to and the exact change to make. It asks for confirmation before updating the live product input.

You: Confirm the update.

Assistant: Sends the update and explains that Merchant Center processes product data asynchronously. The processed product and its quality status can take several minutes to refresh.

Contents

• Quick start
• What you can ask it to do
• How Merchant Center data is connected
• What can change
• Getting access
• Configuration
• Data and telemetry
• Limits and background work
• Technical documentation
• Support

Quick start

You need Node.js 20+, a Google Merchant Center account, OAuth credentials from Google Cloud and a Google Cloud project registered with Merchant Center. The access setup is described in Getting access.

1. Prepare the four values: OAuth client ID, OAuth client secret, OAuth refresh token and Merchant Center account ID.
2. Add the server to your AI app using one of the instructions below.
3. Ask the first read-only question above.

In the app:

1. Open Settings → MCP servers.
2. Select Add server.
3. Choose STDIO, then enter the launch command npx -y mcp-google-merchants@latest and the four environment variables below.

1. Select Save, then Restart.

From the command line:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

Check the connection:

codex mcp list

Codex MCP documentation

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

Check the connection:

claude mcp list

Claude Code MCP documentation

The current official path is Settings → Extensions. For a custom desktop extension, open Advanced settings → Extension Developer → Install Extension…, select a .mcpb file and follow the prompts.

This repository currently publishes an npm stdio package and does not contain a .mcpb bundle. For Claude Desktop builds that still support local configuration, use the following JSON stdio configuration as a fallback:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

In those builds, save it to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Claude Desktop MCP documentation

Add a user-level server to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows:

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Cursor MCP documentation

Run MCP: Open User Configuration from the Command Palette and add:

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

Check the server with MCP: List Servers.

VS Code MCP documentation

What you can ask it to do

Find and understand catalog problems

• Which products are disapproved, and what does Google report for each of them?
• Show the title, price, availability and current status of product SKU-123.
• Which products are out of stock?
• Show the most frequent product issues for this Merchant Center account.

Explore performance and prices

• Show clicks and impressions by product for July.
• Which products are priced above the market benchmark in the United States?
• What prices does Google suggest, and what impact does it predict?

Price comparisons and suggestions require the free Market Insights opt-in in Merchant Center. If the account has not opted in, the server explains why the report has no rows.

Inspect the account and feeds

• List the Merchant Center accounts I can access.
• Is the store homepage claimed? Show the current shipping settings.
• List the product and promotion data sources, and identify an API data source.
• Re-fetch this scheduled file feed now.

Make deliberate changes

• Update the price and availability of this product in its API data source.
• Create an API data source for a new product feed.
• Create or update a promotion and then check its approval status.

For any request that changes data, first ask the assistant to show the target account, data source and exact fields it plans to change.

How Merchant Center data is connected

Merchant Center keeps the incoming data and the resulting product status separate:

1. An account contains product and promotion data sources.
2. A data source can be an API source, a file, a Google Sheet, the Merchant Center interface or an automatic feed.
3. A product input is the product data supplied by one source.
4. A processed product is what Merchant Center derives after processing that input. It includes eligibility and item-level issues.

The server can read every listed source type. It can create API data sources and update product inputs only in an API data source; it cannot write into a file, interface or automatic feed. To find products by condition, use a report query: list_products itself does not provide server-side filtering.

What can change

The MCP client decides how it asks you to confirm write and destructive tools. The server marks its read-only, write and destructive operations so the client can present the right boundary.

Getting access

The server uses the Google Merchant API and the OAuth scope https://www.googleapis.com/auth/content.

1. Create or select a Google Cloud project, enable Merchant API, and configure the OAuth consent screen.
2. In Google Cloud, create an OAuth client of type Desktop app. Save its client ID and client secret.
3. Authorize the Google account that has access to your Merchant Center and obtain a refresh token for the scope above. The OAuth 2.0 Playground can help with this step: enable Use your own OAuth credentials, enter the scope, authorize, then exchange the code for tokens.
4. Find your Merchant Center account ID in Merchant Center and use it as GOOGLE_MERCHANTS_ACCOUNT_ID.
5. Register the Google Cloud project with Merchant Center once. Google requires a production Merchant Center account with a verified website and an account administrator for this operation. The registration links one Cloud project to the Merchant Center account; until it is complete, Merchant API calls from that project are blocked. Follow Google’s developer registration guide.

The one-time registration is available through the technical raw_request tool, but it is safer to follow Google’s guide if this is your first Merchant API setup. Google may take up to five minutes to accept calls after registration.

Treat the OAuth client secret and refresh token as passwords. They are kept in the MCP client configuration and can grant access to the Merchant Center account.

Configuration

* Use either the client ID, client secret and refresh token together, or a pre-minted access token. An access token usually expires in about one hour; a refresh token lets the server obtain a new access token when needed.

Data and telemetry

The server runs locally as a process started by your AI app. It sends Merchant Center requests to Google and refreshes OAuth access tokens through Google’s OAuth endpoint.

It sends anonymous usage telemetry to count active installations and tool demand: a random installation ID, package version, AI client and Node.js/operating-system versions, and the tool name. It never sends or stores OAuth tokens, Merchant Center data, tool arguments or prompts. Disable this telemetry for A1 MCP servers with:

ASKADS_TELEMETRY=0

Limits and background work

• Merchant Center processing is asynchronous. A newly inserted, updated or deleted product input can take several minutes to appear in processed products. Product and promotion approval issues appear later, not as an immediate API error.
• Market Insights is optional. Price competitiveness and suggested-price reports return data only after the account opts into the free Market Insights program.
• Quotas depend on the account and API method. Check current consumption with list_method_quotas; Google’s daily counters reset at 12:00 UTC.
• Temporary limits are handled cautiously. When Google returns 429, the server follows Retry-After when provided and makes a limited number of retries. It does not replay a write after an uncertain network or server failure.
• There is no background monitoring. The server works only while an AI app calls it. If your AI app supports scheduled tasks, you can ask it to check product issues or quota use periodically.
• Aggregated product issues have an account limitation. list_product_issues works for standalone and sub-accounts, not advanced parent accounts.

Technical documentation

• MCP capability catalog — task-oriented pages for every tool.
• All tools and their inputs
• Development documentation
• Publishing documentation
• Google Merchant API overview
• Google Merchant API authentication
• Google developer registration

Support

Found a bug or need a scenario? Create an issue or write in Telegram.