Google Ads MCP

stdio

Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.

Getting Started

npx @getmcp/cli add io.scalably/google-ads-mcp

Requires Python 3.10+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

GOOGLE_ADS_DEVELOPER_TOKEN
Google Ads API developer token from the Ads API Center
GOOGLE_ADS_CLIENT_ID
OAuth2 client_id for a Desktop-app credential
GOOGLE_ADS_CLIENT_SECRET
OAuth2 client_secret paired with the client_id
GOOGLE_ADS_REFRESH_TOKEN
Long-lived OAuth2 refresh_token for the adwords scope
GOOGLE_ADS_LOGIN_CUSTOMER_ID
10-digit customer ID of the manager account (MCC)

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.scalably/google-ads-mcp": {
      "command": "uvx",
      "args": [
        "scalably-google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "",
        "GOOGLE_ADS_CLIENT_ID": "",
        "GOOGLE_ADS_CLIENT_SECRET": "",
        "GOOGLE_ADS_REFRESH_TOKEN": "",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "",
        "GOOGLE_ADS_API_VERSION": "",
        "GOOGLE_ADS_LOG_LEVEL": "",
        "GOOGLE_ADS_USE_PROTO_PLUS": ""
      }
    }
  }
}

Claude Desktop MCP documentation