gmc-mcp

Name: gmc-mcp
Author: kiwoongeom

kiwoongeom

The first free, open-source, self-hosted MCP server for Google Merchant Center (GMC). 126 tools over Merchant API v1 — products, inventory, reports, promotions, returns, account config, audit log + rollback, dry-run. Free alternative to paid SaaS (Adzviser, Catchr, Windsor.ai, Pipedream).

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add gmc --env GMC_ACCOUNT_ID='<GMC_ACCOUNT_ID>' --env GMC_SERVICE_ACCOUNT_KEY='<GMC_SERVICE_ACCOUNT_KEY>' --env GMC_OAUTH_TOKEN='<GMC_OAUTH_TOKEN>' -- uvx gmc-mcp

~/.codex/config.toml

[mcp_servers.gmc]
command = "uvx"
args = ["gmc-mcp"]
env = { GMC_ACCOUNT_ID = "<GMC_ACCOUNT_ID>", GMC_SERVICE_ACCOUNT_KEY = "<GMC_SERVICE_ACCOUNT_KEY>", GMC_OAUTH_TOKEN = "<GMC_OAUTH_TOKEN>" }

# codex mcp add gmc --env GMC_ACCOUNT_ID='<GMC_ACCOUNT_ID>' --env GMC_SERVICE_ACCOUNT_KEY='<GMC_SERVICE_ACCOUNT_KEY>' --env GMC_OAUTH_TOKEN='<GMC_OAUTH_TOKEN>' -- uvx gmc-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "gmc": {
      "command": "uvx",
      "args": [
        "gmc-mcp"
      ],
      "env": {
        "GMC_ACCOUNT_ID": "<GMC_ACCOUNT_ID>",
        "GMC_SERVICE_ACCOUNT_KEY": "<GMC_SERVICE_ACCOUNT_KEY>",
        "GMC_OAUTH_TOKEN": "<GMC_OAUTH_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "gmc": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gmc-mcp"
      ],
      "env": {
        "GMC_ACCOUNT_ID": "<GMC_ACCOUNT_ID>",
        "GMC_SERVICE_ACCOUNT_KEY": "<GMC_SERVICE_ACCOUNT_KEY>",
        "GMC_OAUTH_TOKEN": "<GMC_OAUTH_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "gmc": {
      "command": "uvx",
      "args": [
        "gmc-mcp"
      ],
      "env": {
        "GMC_ACCOUNT_ID": "<GMC_ACCOUNT_ID>",
        "GMC_SERVICE_ACCOUNT_KEY": "<GMC_SERVICE_ACCOUNT_KEY>",
        "GMC_OAUTH_TOKEN": "<GMC_OAUTH_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "gmc": {
      "command": "uvx",
      "args": [
        "gmc-mcp"
      ],
      "env": {
        "GMC_ACCOUNT_ID": "<GMC_ACCOUNT_ID>",
        "GMC_SERVICE_ACCOUNT_KEY": "<GMC_SERVICE_ACCOUNT_KEY>",
        "GMC_OAUTH_TOKEN": "<GMC_OAUTH_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "gmc": {
      "command": "uvx",
      "args": [
        "gmc-mcp"
      ],
      "env": {
        "GMC_ACCOUNT_ID": "<GMC_ACCOUNT_ID>",
        "GMC_SERVICE_ACCOUNT_KEY": "<GMC_SERVICE_ACCOUNT_KEY>",
        "GMC_OAUTH_TOKEN": "<GMC_OAUTH_TOKEN>"
      }
    }
  }
}

Environment variables

GMC_ACCOUNT_ID
GMC_SERVICE_ACCOUNT_KEY
GMC_OAUTH_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related