← Index

Google Ads

io.github.ZLeventer/google-ads-mcp·v1.0.1·Other
Quality Score
90
/100

MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset performance.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<your-google_ads_developer_token>",
        "GOOGLE_ADS_CLIENT_ID": "<your-google_ads_client_id>",
        "GOOGLE_ADS_CLIENT_SECRET": "<your-google_ads_client_secret>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<your-google_ads_refresh_token>",
        "GOOGLE_ADS_CUSTOMER_ID": "<google_ads_customer_id>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<your-google_ads_developer_token>",
        "GOOGLE_ADS_CLIENT_ID": "<your-google_ads_client_id>",
        "GOOGLE_ADS_CLIENT_SECRET": "<your-google_ads_client_secret>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<your-google_ads_refresh_token>",
        "GOOGLE_ADS_CUSTOMER_ID": "<google_ads_customer_id>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @zleventer/google-ads-mcp
§02  Environment variables
GOOGLE_ADS_DEVELOPER_TOKEN
requiredsecret

Google Ads developer token (apply at https://developers.google.com/google-ads/api/docs/get-started/dev-token)

GOOGLE_ADS_CLIENT_ID
requiredsecret

OAuth 2.0 client ID from Google Cloud Console

GOOGLE_ADS_CLIENT_SECRET
requiredsecret

OAuth 2.0 client secret from Google Cloud Console

GOOGLE_ADS_REFRESH_TOKEN
requiredsecret

OAuth 2.0 refresh token with https://www.googleapis.com/auth/adwords scope

GOOGLE_ADS_CUSTOMER_ID
required

Default Google Ads customer ID (numeric, no dashes). Can be overridden per tool call.

GOOGLE_ADS_LOGIN_CUSTOMER_ID

Manager (MCC) account ID — required only if accessing accounts under an MCC

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
10
§04  Alternatives in Other