Google Ads MCP Server

MCP server that lets any LLM (Claude, Cursor, etc.) manage Google Ads campaigns from the terminal. Supports read and write operations.

Quick Start

pip install google-ads-mcp
google-ads-mcp auth

The auth command walks you through getting credentials, opens your browser for Google sign-in, and saves everything to ~/.config/google-ads-mcp/credentials.json.

Then add to your .mcp.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "google-ads-mcp",
      "args": ["serve"]
    }
  }
}

No environment variables needed — the server auto-loads saved credentials.

Alternative: uvx (no install)

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": ["google-ads-mcp", "serve"]
    }
  }
}

Run uvx google-ads-mcp auth first to set up credentials.

Alternative: environment variables

If you prefer env vars over saved credentials:

{
  "mcpServers": {
    "google-ads": {
      "command": "google-ads-mcp",
      "args": ["serve"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "your-secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Env vars take priority over saved credentials when both are present.

Tools (10)

Read

• list_accounts — List accessible customer accounts
• list_campaigns — List campaigns with status & budget
• get_campaign_performance — Impressions, clicks, cost, conversions, CTR, CPC

Write

• create_campaign — Create a search campaign (PAUSED by default)
• update_campaign_budget — Change daily budget
• pause_campaign / enable_campaign — Toggle campaign status
• create_ad_group — Create ad group in a campaign
• add_keywords — Add keywords to an ad group (EXACT, PHRASE, BROAD)
• create_ad — Create responsive search ad

Development Setup

cd google_ads_mcp
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Tests

pytest tests/ -v

All tests use mocked Google Ads client — no credentials needed.

Design decisions

• Dollar amounts in params (not micros) — LLMs think in dollars
• Campaigns created PAUSED by default — safety first
• All tools return JSON — structured output for LLMs
• Errors return JSON too (never raise) — actionable diagnostics
• Lazy client init — defers credential validation to first call
• Credential priority: env vars > saved file (~/.config/google-ads-mcp/credentials.json)