Skip to main content
Glama
GMC MCP Server

GMC MCP Server

by archpeng

GMC MCP Server

Google Merchant Center MCP Server — 34 tools across 9 modules, built on Google Content API v2.1.

Quick Start

# 1. Auth — Service Account (recommended)
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# 2. Install
cp .env.example .env   # fill in GMC_MERCHANT_ID
bash bootstrap.sh

# 3. Run
bash run.sh

Related MCP server: mcp-google-merchant-center

Tool Reference (34 tools)

🔐 Account & Programs (account.py)

Tool

Description

get_account_info

Basic account info

get_account_status

Account suspension / Misrepresentation issues

get_account_tax

Tax settings

list_datafeeds

List all data feeds

get_datafeed_status

Feed health check (errors, item counts)

list_datafeed_statuses

All feeds health check

trigger_datafeed_fetch

⚡ Manually trigger a feed refresh

get_shopping_ads_program

Shopping Ads program status

request_shopping_ads_review

⚠️ Submit re-review request to Google

get_free_listings_program

Free Listings program status

request_free_listings_review

Submit Free Listings re-review

list_api_quotas

API quota usage

📦 Products (products.py)

Tool

Description

list_products

List products (paginated)

get_product

Get single product details

insert_product

Create / replace a product

update_product

Partially update a product (PATCH)

delete_product

Delete a product

list_product_statuses

Approval status + issues for all products

get_product_status

Approval status for single product

count_products_by_status

Summary: approved / disapproved / pending counts

🛠️ Merchant Support (support.py)

Tool

Description

render_account_issues

Human-readable account issues + fix steps

render_product_issues

Human-readable product issues + fix steps

trigger_support_action

⚠️ Trigger a GMC support action (e.g. appeal)

📊 Reports (reports.py)

Tool

Description

reports_search

MQL query (clicks, impressions, price competitiveness…)

get_product_performance

Convenience: clicks/impressions by date range

🗺️ Inventory (inventory.py)

Tool

Description

insert_regional_inventory

Set regional price/availability overrides

insert_local_inventory

Update in-store inventory

🏷️ Promotions (promotions.py)

Tool

Description

list_promotions

List promotions

get_promotion

Get promotion details

create_promotion

Create a discount promotion

🚚 Shipping (shipping.py)

Tool

Description

get_shipping_settings

Get shipping services and rates

update_shipping_settings

Update shipping configuration

get_supported_carriers

List supported carriers

get_supported_holidays

List supported holiday cutoff dates

🔄 Return Policy (returnpolicy.py)

Tool

Description

list_return_policies

List all return policies

get_return_policy

Get policy details

create_return_policy

Create a new return policy

patch_return_policy

Update a return policy

delete_return_policy

Delete a return policy

🗂️ Collections (collections.py)

Tool

Description

list_collections

List product collections

get_collection

Get collection details

get_collection_status

Get collection approval status

create_collection

Create a new collection

💡 Recommendations (recommendations.py)

Tool

Description

get_recommendations

Get GMC optimization recommendations

Claude / Cursor Config

Add to mcp_config.json:

{
  "mcpServers": {
    "gmc": {
      "command": "/absolute/path/to/GMC-mcp-server/run.sh"
    }
  }
}

Auth Notes

Method

Setup

Service Account JSON

export GOOGLE_APPLICATION_CREDENTIALS=/path/sa.json → add SA email as Admin in GMC

Local dev

gcloud auth application-default login --scopes=https://www.googleapis.com/auth/content

No Developer Token required. No Google approval needed. Self-serve via Google Cloud Console.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Google Merchant Center, providing 126 tools to manage Google Shopping feed, products, inventory, reports, promotions, returns, and account configuration via natural language.
      813 PyPI
      19
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage Google Merchant Center accounts via the Merchant API, including product feeds, promotions, data sources, and MCQL reports with read and write operations.
      28
      161 npm
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables management of Google Ads accounts via MCP, providing read and write tools for campaigns, ad groups, keywords, assets, and more, with support for reporting and mutations.
      -