Google Ads MCP Server

What the code does

We read the source, 22 h ago · rules 3dff92dd89df

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

  const child = spawn(command, args, { detached: true, stdio: "ignore" });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add google-ads-mcp -- npx -y google-ads-mcp-unofficial

{
  "mcpServers": {
    "google-ads-mcp": {
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.google-ads-mcp]
command = "npx"
args = ["-y", "google-ads-mcp-unofficial"]

{
  "mcpServers": {
    "google-ads-mcp": {
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "google-ads-mcp": {
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: GOOGLE_ADS_DEVELOPER_TOKEN (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 (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.). The author declared them in the registry entry; get the values from the project itself.