Gmc MCP server
io.github.kiwoongeom/gmc-mcp·v0.2.5·15 starsMIT-licensed pip-installable MCP for Google Merchant Center on Merchant API v1 (126 tools).
15 stars526 downloads/wk
Reviews
Write oneNobody has reviewed Gmc yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Gmc tools (100, 39 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
gmc_accept_tosAccept a TermsOfService.
gmc_add_userAdd a user to the Merchant Center account.
gmc_approve_account_serviceApprove a proposed service relationship.
gmc_audit_lookupLook up an audit log entry by ID. Useful for diagnosing failed writes or rolling back.
gmc_audit_tailShow the most recent audit log entries.
gmc_bulk_delete_productswrite actionBulk-delete product inputs. DESTRUCTIVE — requires confirm='DELETE'.
gmc_bulk_set_availabilityBulk-set availability ('IN_STOCK', 'OUT_OF_STOCK', etc.) for many products.
gmc_bulk_update_regional_priceswrite actionBulk-update regional inventory prices.
gmc_claim_homepageClaim ownership of the homepage. Set overwrite=True to take over from another claimant on the same domain.
gmc_create_aggregationwrite actionAggregate this account under a provider (typically an MCA/aggregator).
gmc_create_checkout_settingswrite actionCreate URI checkout settings (program is always 'checkout' in v1).
gmc_create_conversion_sourcewrite actionCreate a conversion source. Examples:
gmc_create_omnichannel_settingswrite actionCreate omnichannel settings for a region.
gmc_create_primary_feedwrite actionCreate an API-based primary product feed.
gmc_create_supplemental_feedwrite actionCreate an API-based supplemental product feed.
gmc_delete_aggregationwrite actionRemove the current aggregation from a provider.
gmc_delete_checkout_settingswrite actionDelete URI checkout settings (program defaults to 'checkout').
gmc_delete_conversion_sourcewrite actionSoft-delete a conversion source (recoverable via undelete).
gmc_delete_datasourcewrite actionDelete a data source. Cannot delete a primary feed if products depend on it.
gmc_delete_productwrite actionDelete a product input.
gmc_describe_serverShow what this server is connected to and how it's configured.
gmc_diff_with_shopifyCompare a Shopify product CSV (exported from admin) against GMC products.
gmc_export_allDump products, issues, datasources, return policies, account info to JSON files.
gmc_fetch_datasourceTrigger an immediate fetch of a file-based data source (must have a fetch URL).
gmc_get_accountGet the current Merchant Center account information.
gmc_get_account_taxGet US account tax settings.
gmc_get_autofeed_settingsGet autofeed (Google crawls your site to build a feed) settings.
gmc_get_automatic_improvementsGet current automatic-improvements settings (item updates, image, shipping, prices).
gmc_get_business_identityGet business identity (women-owned, minority-owned, veteran-owned, etc.). Google can show badges on your listings based on these attributes.
gmc_get_business_infoGet business identity info (address, phone, customer service).
gmc_get_checkout_settingsGet URI checkout settings.
gmc_get_conversion_sourcegmc_get_datasourceGet a single data source by its ID (numeric).
gmc_get_email_preferenceswrite actionGet email-notification preferences for a user. email: the user's email exactly as it appears in Account Access.
gmc_get_homepageGet the registered homepage URI and its claim status.
gmc_get_latest_tosRetrieve the latest TermsOfService document.
gmc_get_omnichannel_settingsgmc_get_productGet a single product by its full product ID.
gmc_get_product_statusGet the status (approval, issues, destinations) of a single product.
gmc_get_program_reviewGet the current review state of a program (pending/approved/disapproved/etc.).
gmc_get_promotionGet a single promotion by ID.
gmc_get_regionGet one region by ID.
gmc_get_relationshipgmc_get_shipping_settingsGet shipping settings (services, rate groups, delivery times).
gmc_health_checkProbe core endpoints and report which respond. Useful first call after setup.
gmc_insert_productwrite actionInsert or update a product via productInputs (Merchant API v1).
gmc_insert_promotionwrite actionInsert or update a promotion.
gmc_lfp_delete_storewrite actiongmc_lfp_get_merchant_stateGet the current LFP onboarding/sync state for a target merchant.
gmc_lfp_get_storegmc_lfp_insert_inventorywrite actionPush one local inventory record. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "offerId": "SKU1", "regionCode": "US", "contentLanguage": "en", "price": {"amountMicros": "19990000", "currencyCode": "USD"}, "availability": "IN_STOCK", "quantity": "12" }
gmc_lfp_insert_salewrite actionPush one local sale event. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "offerId": "SKU1", "regionCode": "US", "contentLanguage": "en", "price": {"amountMicros": "19990000", "currencyCode": "USD"}, "quantity": "1", "saleTime": "2026-04-30T19:30:00Z", "uid": "txn-abc123" }
gmc_lfp_insert_storewrite actionCreate / upsert an LFP store. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "storeAddress": "123 Main St, City, ST 00000", "storeName": "Main Street Store", "phoneNumber": "+1-555-0100", "websiteUri": "https://store.com/locations/1" }
gmc_lfp_list_storesList stores LFP-linked to a target merchant account.
gmc_link_gbp_accountLink a Google Business Profile account so its store locations sync to GMC.
gmc_list_account_issuesList all account-level issues (policy, missing settings, etc).
gmc_list_account_servicesList service relationships (where someone delegates account management).
gmc_list_conversion_sourcesList conversion sources (Google Tag, Google Analytics, Merchant Center Destination).
gmc_list_datasourcesList all data sources (primary, supplemental, file-based, API-based).
gmc_list_disapproved_productsList products that are currently disapproved on Google Shopping.
gmc_list_gbp_accountsList linked Google Business Profile accounts.
gmc_list_local_inventoriesList local inventories for a product.
gmc_list_omnichannel_settingsList per-region omnichannel settings.
gmc_list_productsList all products in the Merchant Center account.
gmc_list_programsList participation in Merchant Center programs (Shopping Ads, Free Listings, etc.).
gmc_list_promotionsList all promotions in the Merchant Center.
gmc_list_quotasList the API quota usage / limits for this account.
gmc_list_regional_inventoriesList regional inventories for a product.
gmc_list_regionsList all regions configured on the account.
gmc_list_relationshipsList parent / child / aggregator relationships involving this account.
gmc_list_subscriptionsList push-notification subscriptions on this account.
gmc_list_tos_agreement_statesList the TOS agreement states for the current account.
gmc_list_usersList users with access to this Merchant Center account.
gmc_propose_account_servicePropose a service relationship (e.g. account management delegation).
gmc_reject_account_serviceReject a proposed service relationship.
gmc_remove_userwrite actionRemove a user from the Merchant Center account.
gmc_request_inventory_verificationRequest Google to verify your inventory accuracy in a region.
gmc_request_program_reviewRequest a manual review of a program after fixing disapproval issues.
gmc_rollbackRoll back a previous write using its audit `before` snapshot.
gmc_set_dry_runwrite actionToggle dry-run mode for this session. When enabled, write operations are recorded to the audit log but NOT sent to Merchant API.
gmc_subscribewrite actionCreate a notification subscription.
gmc_summarize_product_issuesScan products and aggregate issue codes by frequency.
gmc_unclaim_homepageRelease the homepage claim.
gmc_undelete_conversion_sourceUndelete a soft-deleted conversion source.
gmc_unsubscribewrite actionDelete a notification subscription by ID.
gmc_update_account_taxwrite actionUpdate US tax rules. Body example: [ {"region": "US-CA", "useGoogleRate": True, "shippingTaxed": False}, {"region": "US-NY", "ratePercent": 8.0, "shippingTaxed": True} ]
gmc_update_autofeed_settingswrite actionEnable / disable autofeed product crawling.
gmc_update_automatic_improvementswrite actionToggle automatic improvements. Body example: { "itemUpdates": {"accountItemUpdatesSettings": { "allowPriceUpdates": True, "allowAvailabilityUpdates": True, "allowConditionUpdates": True, "allowStrictAvailabilityUpdates": True }}, "imageImprovements": {"accountImageImprovementsSettings": { "allowAutomaticImageImprovements": True }}, "shippingImprovements": {"allowShippingImprovements": True} }
gmc_update_business_identitywrite actionPatch business identity. Body example: { "blackOwned": {"identityDeclaration": "SELF_IDENTIFIES_AS"}, "womenOwned": {"identityDeclaration": "SELF_IDENTIFIES_AS"}, "promotionsConsent": "PROMOTIONS_CONSENT_GIVEN_FOR_PROMOTIONS" }
gmc_update_business_infowrite actionPatch business info. Body example: { "address": { "regionCode": "US", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": ["1600 Amphitheatre Pkwy"] }, "phone": {"e164Number": "+14155551234"}, "customerService": { "uri": "https://store.com/contact", "email": "support@store.com", "phone": {"e164Number": "+18005551234"} }, "koreanBusinessRegistrationNumber
gmc_update_checkout_settingswrite actionPatch URI checkout settings (program is always 'checkout' in v1).
gmc_update_conversion_sourcewrite actiongmc_update_email_preferenceswrite actionUpdate email preferences. preferences example: {"newsAndTips": "OPTED_IN"} # or OPTED_OUT
gmc_update_homepagewrite actionUpdate the homepage URI. update_mask defaults to 'uri'.
gmc_update_local_inventorywrite actionInsert or update local (in-store) inventory for a product (Merchant API v1).
gmc_update_omnichannel_settingswrite actiongmc_update_productwrite actionUpdate a product. Implemented as productInputs:insert (upsert).
gmc_update_regional_inventorywrite actionInsert or update regional inventory for a product (Merchant API v1).
gmc_update_relationshipwrite actiongmc_update_shipping_settingswrite actionUpdate shipping settings. Body must be a complete ShippingSettings object.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan30 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 148 days ago8/15
- Maintainer identityregistry namespace matches repository owner6/10
How Gmc compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 69/100
- higher than 33% of 48,255 servers
- Tools
- 100
- the typical server has 7
- Tools that change things
- 39%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 15
- more than 90% of 28,688 servers
- Downloads a week
- 526
- more than 89% of 12,191 servers with a package
What its tools let an agent do: 61 read · 39 change
Install Gmc in Claude Code, Cursor or VS Code
claude mcp add gmc-mcp -- uvx gmc-mcp
What the publisher says
From the Gmc repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.kiwoongeom/gmc-mcp -->
Google Merchant Center MCP (gmc-mcp)
MCP server for Google Merchant Center, built on Merchant API v1.
126 tools, MIT-licensed, pip install-able. Drive your Google Shopping
feed, products, inventory, Reports, promotions, returns, and account
configuration in natural language from Claude Desktop, Claude Code, or any
MCP-compatible client.
### Where this fits in the GMC + MCP landscape
| Option | Type | API | License | Install | Tools |
|---|---|---|---|---|---|
| Adzviser / Catchr / Windsor.ai / Pipedream | Paid hosted SaaS | varies | proprietary | sign-up | varies |
| archpeng/GMC-mcp-server | Self-hosted | Content API v2.1 (deprecated 2026-08) | none declared | git clone | 34 |
| gmc-mcp (this package) | Self-hosted | Merchant API v1 (future-proof) | MIT | pip install gmc-mcp | 126 |
Pick this if you want: future-proof API, an actual OSS license, PyPI install,
a larger toolset, audit log + rollback + dry-run safety, and credentials that
never leave your machine.
Built on Merchant API v1 (replaces Content API for Shopping; v1beta was discontinued 2026-02-28). Safe by default: every write is recorded to an append-only audit log with before snapshots, dry-run is one toggle away, and destructive bulk operations require an explicit confirm parameter.
Why this exists
Google Merchant Center (GMC) powers Google Shopping listings, Free Listings, Shopping Ads, Buy on Google checkout, YouTube Shopping, and more. Managing a feed of thousands of products through the GMC web UI is tedious, and writing one-off Python scripts against the Merchant API REST endpoints is slow.
There are existing MCP services for GMC, but they fit different niches:
is proxied through their servers; monthly subscription.
- Paid hosted SaaS (Adzviser, Catchr, Windsor.ai, Pipedream) — your data
but built on the deprecated Content API v2.1 which Google retires in August 2026, has no license declared, and isn't on PyPI.
- archpeng/GMC-mcp-server — earliest self-hosted Python option (Feb 2026),
gmc-mcp was built to fill the gap: a self-hosted package on the new Merchant API v1, MIT-licensed, on PyPI, with audit/rollback/dry-run safety and 126 tools across 19 modules.
The package gives Claude (or any MCP client) 126 tools that map directly onto the Merchant API v1 surface, so you can do things like:
- "Show me every disapproved product, grouped by issue code."
- "Bump US prices 5% on these 40 SKUs."
- "Which products had impressions but zero clicks last week?"
- "Roll back audit ID 8fc8dc42… — that update broke something."
- "Compare this Shopify CSV against my GMC feed; what's missing?"
What's exposed
126 tools across 19 modules + 4 meta tools.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Gmc: common questions
- Is Gmc MCP server safe?
- With care: it is graded C, so read the findings first (69/100). Read the Gmc safety report
- How do I install Gmc?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Gmc need an API key?
- Yes. The registry entry asks for
GMC_SERVICE_ACCOUNT_KEY,GMC_OAUTH_TOKEN. - Is Gmc maintained?
- The last commit was 186 days ago (2026-05-02). The latest release is v0.2.5.
- How does Gmc compare with other MCP servers?
- safety score 69/100 (higher than 33% of 48,255 servers); tools 100 (the typical server has 7); tools that change things 39% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.