io.github.davidmosiah/google-ads-mcp

io.github.davidmosiah/google-ads-mcp·v0.1.3·Documents & Spreadsheets

Unofficial Google Ads MCP for campaigns, keywords, budgets, and gated mutations.

Trust verdict · v1 advisory · method

NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

Environment variables

GOOGLE_ADS_DEVELOPER_TOKEN

secret

Google Ads API developer token from your Google Ads Manager account. Required.

GOOGLE_ADS_CLIENT_ID

Google OAuth2 client ID. Required.

GOOGLE_ADS_CLIENT_SECRET

secret

Google OAuth2 client secret. Prefer storing in ~/.google-ads-mcp/config.json via setup.

GOOGLE_ADS_LOGIN_CUSTOMER_ID

Manager (MCC) customer ID used as login-customer-id header, no dashes (e.g., 1234567890). Optional but required for multi-account access.

GOOGLE_ADS_REDIRECT_URI

OAuth redirect URI. Defaults to http://127.0.0.1:3000/callback.

GOOGLE_ADS_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.google-ads-mcp/tokens.json (0600).

GOOGLE_ADS_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw returns full Google Ads API payloads.

GOOGLE_ADS_ALLOW_MUTATIONS

Set to true to enable write tools (pause/resume keywords/campaigns, set bids, set budgets). Default false (read-only). Agents changing real ad spend is high-stakes; review every change.

GOOGLE_ADS_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

GOOGLE_ADS_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.google-ads-mcp/cache.sqlite.

GOOGLE_ADS_CACHE_TTL_SECONDS

Optional cache TTL in seconds. Defaults to 60. Set to 0 to keep entries indefinitely (entries are still overwritten on each hit).

GOOGLE_ADS_NO_RETRY

Set to true to disable the HTTP retry middleware. Default false.

MCP quality score · maturity, not trust · methodology

freshness

completeness

installability

documentation

stability

Alternatives in Documents & Spreadsheets

ac.tandem/docs-mcp

Remote MCP server for Tandem docs, install guides, SDKs, workflows, and agent setup help.

ai.adramp/google-ads

Google Ads MCP server — manage campaigns, keywords, and metrics.

AutEng MCP - Markdown Publishing & Document Share Links

ai.auteng/docs

Publish markdown documents as public share links with mermaid diagram support. Built by AutEng.ai

Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<your-google_ads_developer_token>",
        "GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
        "GOOGLE_ADS_CLIENT_SECRET": "<your-google_ads_client_secret>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
        "GOOGLE_ADS_REDIRECT_URI": "<google_ads_redirect_uri>",
        "GOOGLE_ADS_TOKEN_PATH": "<google_ads_token_path>",
        "GOOGLE_ADS_PRIVACY_MODE": "<google_ads_privacy_mode>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<google_ads_allow_mutations>",
        "GOOGLE_ADS_CACHE": "<google_ads_cache>",
        "GOOGLE_ADS_CACHE_PATH": "<google_ads_cache_path>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<google_ads_cache_ttl_seconds>",
        "GOOGLE_ADS_NO_RETRY": "<google_ads_no_retry>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<your-google_ads_developer_token>",
        "GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
        "GOOGLE_ADS_CLIENT_SECRET": "<your-google_ads_client_secret>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
        "GOOGLE_ADS_REDIRECT_URI": "<google_ads_redirect_uri>",
        "GOOGLE_ADS_TOKEN_PATH": "<google_ads_token_path>",
        "GOOGLE_ADS_PRIVACY_MODE": "<google_ads_privacy_mode>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<google_ads_allow_mutations>",
        "GOOGLE_ADS_CACHE": "<google_ads_cache>",
        "GOOGLE_ADS_CACHE_PATH": "<google_ads_cache_path>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<google_ads_cache_ttl_seconds>",
        "GOOGLE_ADS_NO_RETRY": "<google_ads_no_retry>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y google-ads-mcp-unofficial

Verdict API

curl -s mcpindex.ai/api/v1/trust/server/io-github-davidmosiah-google-ads-mcp

Free-tier verdict as JSON: decision + dimensions + severity. Call it from your agent before it invokes a tool it just discovered.

Details

version: v0.1.3
category: Documents & Spreadsheets
quality: 85 / 100
operator: davidmosiah

Provenance

Verdict history is anchored to Bitcoin via OpenTimestamps. The free tier returns the current verdict only; the anchored record is served on the authenticated tier.

Links

Repository →Website →