gmc-mcp
A self-hosted, MIT-licensed MCP server for Google Merchant Center built on Merchant API v1. It provides 126 tools to manage products, inventory, reports, promotions, returns, and account configuration. It features safety mechanisms like audit logs, rollback capabilities, and dry-run modes, allowing agents to drive Google Shopping feeds via natural language.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 19 GitHub stars
What you can do with it
- Manage product listings and inventory via natural language
- Generate reports on impressions and clicks
- Configure account settings and promotions
- Roll back changes using audit logs
Source and maintenance
- Last repository push
- Latest release
- v0.2.1
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
gmc-mcp 0.2.5
{
"version": "0.2.5",
"transport": "stdio",
"identifier": "gmc-mcp",
"registryType": "pypi",
"environmentVariables": [
{
"name": "GMC_ACCOUNT_ID",
"format": "string",
"isRequired": true,
"description": "Your 10-digit Google Merchant Center account ID (top-right of merchants.google.com)."
},
{
"name": "GMC_SERVICE_ACCOUNT_KEY",
"format": "filepath",
"description": "Absolute path to a Google Cloud service-account JSON key file. The service account must be added as Admin in Merchant Center."
},
{
"name": "GMC_OAUTH_TOKEN",
"format": "filepath",
"description": "Absolute path to an OAuth user-token JSON file produced by `gmc-mcp auth-init`. Use this OR GMC_SERVICE_ACCOUNT_KEY."
},
{
"name": "GMC_SUBACCOUNT_ID",
"format": "string",
"description": "Optional sub-account ID when operating an MCA (Multi-Client Account)."
},
{
"name": "GMC_DRY_RUN",
"format": "string",
"default": "false",
"description": "When 'true', writes are logged to the audit log only (no actual API calls)."
},
{
"name": "GMC_LOG_LEVEL",
"format": "string",
"default": "INFO",
"description": "Log verbosity: DEBUG / INFO / WARNING / ERROR."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"gmc-mcp": {
"command": "uvx",
"args": [
"gmc-mcp==0.2.5"
],
"env": {
"GMC_ACCOUNT_ID": "<YOUR_GMC_ACCOUNT_ID>",
"GMC_SERVICE_ACCOUNT_KEY": "<YOUR_GMC_SERVICE_ACCOUNT_KEY>",
"GMC_OAUTH_TOKEN": "<YOUR_GMC_OAUTH_TOKEN>",
"GMC_SUBACCOUNT_ID": "<YOUR_GMC_SUBACCOUNT_ID>",
"GMC_DRY_RUN": "<YOUR_GMC_DRY_RUN>",
"GMC_LOG_LEVEL": "<YOUR_GMC_LOG_LEVEL>"
}
}
}
}Cline
{
"mcpServers": {
"gmc-mcp": {
"command": "uvx",
"args": [
"gmc-mcp==0.2.5"
],
"env": {
"GMC_ACCOUNT_ID": "<YOUR_GMC_ACCOUNT_ID>",
"GMC_SERVICE_ACCOUNT_KEY": "<YOUR_GMC_SERVICE_ACCOUNT_KEY>",
"GMC_OAUTH_TOKEN": "<YOUR_GMC_OAUTH_TOKEN>",
"GMC_SUBACCOUNT_ID": "<YOUR_GMC_SUBACCOUNT_ID>",
"GMC_DRY_RUN": "<YOUR_GMC_DRY_RUN>",
"GMC_LOG_LEVEL": "<YOUR_GMC_LOG_LEVEL>"
}
}
}
}VS Code
{
"servers": {
"gmc-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gmc-mcp==0.2.5"
],
"env": {
"GMC_ACCOUNT_ID": "<YOUR_GMC_ACCOUNT_ID>",
"GMC_SERVICE_ACCOUNT_KEY": "<YOUR_GMC_SERVICE_ACCOUNT_KEY>",
"GMC_OAUTH_TOKEN": "<YOUR_GMC_OAUTH_TOKEN>",
"GMC_SUBACCOUNT_ID": "<YOUR_GMC_SUBACCOUNT_ID>",
"GMC_DRY_RUN": "<YOUR_GMC_DRY_RUN>",
"GMC_LOG_LEVEL": "<YOUR_GMC_LOG_LEVEL>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"gmc-mcp": {
"command": "uvx",
"args": [
"gmc-mcp==0.2.5"
],
"env": {
"GMC_ACCOUNT_ID": "<YOUR_GMC_ACCOUNT_ID>",
"GMC_SERVICE_ACCOUNT_KEY": "<YOUR_GMC_SERVICE_ACCOUNT_KEY>",
"GMC_OAUTH_TOKEN": "<YOUR_GMC_OAUTH_TOKEN>",
"GMC_SUBACCOUNT_ID": "<YOUR_GMC_SUBACCOUNT_ID>",
"GMC_DRY_RUN": "<YOUR_GMC_DRY_RUN>",
"GMC_LOG_LEVEL": "<YOUR_GMC_LOG_LEVEL>"
}
}
}
}Let your agent find its tools
Find servers like gmc-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.