Google Ads MCP Server

Google Ads MCP setup: run Google's official read-only server in Claude to query campaigns with GAQL. Plus hosted options if you need to make changes.

Pricing

free

GitHub stars

971

Last commit

2026-09-21

Page updated

2026-09-22

Free and open source from Google. Needs a Google Cloud project and a Google Ads developer token.

Official vs community Google Ads MCP

What you can ask it

• “List every search term from the last 30 days with more than $50 spend and zero conversions, grouped by campaign”
• “Compare Performance Max vs. Search campaigns on cost, conversions and conversion value for last month”
• “Which keywords have a Quality Score under 5 and more than 1,000 impressions this quarter?”
• “Show daily spend for customer 1234567890 over the last 14 days and flag any day more than 30% above the average”
• “Find ad groups where CTR dropped more than 25% week over week”

Features

• Official server maintained by Google's Google Ads API team
• `list_accessible_customers` finds every account your login can reach
• `search` runs any GAQL query for campaign, ad group, keyword and search term reports
• `get_resource_metadata` tells Claude which fields and metrics exist, so it writes valid queries
• Read-only by design. No bid, budget or status changes
• Runs locally over stdio, or on Cloud Run with an OAuth proxy for teams
• Manager (MCC) accounts supported via `GOOGLE_ADS_LOGIN_CUSTOMER_ID`

How to set up the Google Ads MCP Server

Works with: Claude Desktop, Claude Code, Cursor, VS Code, Codex, Antigravity

gcloud auth application-default login \
    --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
    --client-id-file=YOUR_CLIENT_JSON_FILE

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_CUSTOMER_ID"
      }
    }
  }
}

claude mcp add google-ads \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json \
  -e GOOGLE_PROJECT_ID=your-project-id \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token \
  -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

Alternatives

FAQ

More marketing MCP servers