PluginBench
MCP Server
Active
MIT

io.github.davidmosiah/google-ads-mcp MCP Server

io.github.davidmosiah/google-ads-mcp

RepositoryRegistry

What is the io.github.davidmosiah/google-ads-mcp MCP server?

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

How to install io.github.davidmosiah/google-ads-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • 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.

Claude Desktop
~/Library/Application Support/Claude/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": "<YOUR_GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<YOUR_GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "GOOGLE_ADS_REDIRECT_URI": "<YOUR_GOOGLE_ADS_REDIRECT_URI>",
        "GOOGLE_ADS_TOKEN_PATH": "<YOUR_GOOGLE_ADS_TOKEN_PATH>",
        "GOOGLE_ADS_PRIVACY_MODE": "<YOUR_GOOGLE_ADS_PRIVACY_MODE>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<YOUR_GOOGLE_ADS_ALLOW_MUTATIONS>",
        "GOOGLE_ADS_CACHE": "<YOUR_GOOGLE_ADS_CACHE>",
        "GOOGLE_ADS_CACHE_PATH": "<YOUR_GOOGLE_ADS_CACHE_PATH>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<YOUR_GOOGLE_ADS_CACHE_TTL_SECONDS>",
        "GOOGLE_ADS_NO_RETRY": "<YOUR_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": "<YOUR_GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<YOUR_GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "GOOGLE_ADS_REDIRECT_URI": "<YOUR_GOOGLE_ADS_REDIRECT_URI>",
        "GOOGLE_ADS_TOKEN_PATH": "<YOUR_GOOGLE_ADS_TOKEN_PATH>",
        "GOOGLE_ADS_PRIVACY_MODE": "<YOUR_GOOGLE_ADS_PRIVACY_MODE>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<YOUR_GOOGLE_ADS_ALLOW_MUTATIONS>",
        "GOOGLE_ADS_CACHE": "<YOUR_GOOGLE_ADS_CACHE>",
        "GOOGLE_ADS_CACHE_PATH": "<YOUR_GOOGLE_ADS_CACHE_PATH>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<YOUR_GOOGLE_ADS_CACHE_TTL_SECONDS>",
        "GOOGLE_ADS_NO_RETRY": "<YOUR_GOOGLE_ADS_NO_RETRY>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_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": "<YOUR_GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<YOUR_GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "GOOGLE_ADS_REDIRECT_URI": "<YOUR_GOOGLE_ADS_REDIRECT_URI>",
        "GOOGLE_ADS_TOKEN_PATH": "<YOUR_GOOGLE_ADS_TOKEN_PATH>",
        "GOOGLE_ADS_PRIVACY_MODE": "<YOUR_GOOGLE_ADS_PRIVACY_MODE>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<YOUR_GOOGLE_ADS_ALLOW_MUTATIONS>",
        "GOOGLE_ADS_CACHE": "<YOUR_GOOGLE_ADS_CACHE>",
        "GOOGLE_ADS_CACHE_PATH": "<YOUR_GOOGLE_ADS_CACHE_PATH>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<YOUR_GOOGLE_ADS_CACHE_TTL_SECONDS>",
        "GOOGLE_ADS_NO_RETRY": "<YOUR_GOOGLE_ADS_NO_RETRY>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "google-ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-ads-mcp-unofficial"
      ],
      "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_LOGIN_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "GOOGLE_ADS_REDIRECT_URI": "<YOUR_GOOGLE_ADS_REDIRECT_URI>",
        "GOOGLE_ADS_TOKEN_PATH": "<YOUR_GOOGLE_ADS_TOKEN_PATH>",
        "GOOGLE_ADS_PRIVACY_MODE": "<YOUR_GOOGLE_ADS_PRIVACY_MODE>",
        "GOOGLE_ADS_ALLOW_MUTATIONS": "<YOUR_GOOGLE_ADS_ALLOW_MUTATIONS>",
        "GOOGLE_ADS_CACHE": "<YOUR_GOOGLE_ADS_CACHE>",
        "GOOGLE_ADS_CACHE_PATH": "<YOUR_GOOGLE_ADS_CACHE_PATH>",
        "GOOGLE_ADS_CACHE_TTL_SECONDS": "<YOUR_GOOGLE_ADS_CACHE_TTL_SECONDS>",
        "GOOGLE_ADS_NO_RETRY": "<YOUR_GOOGLE_ADS_NO_RETRY>"
      }
    }
  }
}
Claude Code
claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN> --env GOOGLE_ADS_CLIENT_ID=<YOUR_GOOGLE_ADS_CLIENT_ID> --env GOOGLE_ADS_CLIENT_SECRET=<YOUR_GOOGLE_ADS_CLIENT_SECRET> --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID> --env GOOGLE_ADS_REDIRECT_URI=<YOUR_GOOGLE_ADS_REDIRECT_URI> --env GOOGLE_ADS_TOKEN_PATH=<YOUR_GOOGLE_ADS_TOKEN_PATH> --env GOOGLE_ADS_PRIVACY_MODE=<YOUR_GOOGLE_ADS_PRIVACY_MODE> --env GOOGLE_ADS_ALLOW_MUTATIONS=<YOUR_GOOGLE_ADS_ALLOW_MUTATIONS> --env GOOGLE_ADS_CACHE=<YOUR_GOOGLE_ADS_CACHE> --env GOOGLE_ADS_CACHE_PATH=<YOUR_GOOGLE_ADS_CACHE_PATH> --env GOOGLE_ADS_CACHE_TTL_SECONDS=<YOUR_GOOGLE_ADS_CACHE_TTL_SECONDS> --env GOOGLE_ADS_NO_RETRY=<YOUR_GOOGLE_ADS_NO_RETRY> -- npx -y google-ads-mcp-unofficial

Related MCP servers

io.github.davidmosiah/google-health-mcp

Active

Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents

18
TypeScript
MIT
View repository →

io.github.davidmosiah/wellness-nourish

Active

Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals.

7
TypeScript
MIT
View repository →

io.github.davidmosiah/whoop-mcp

Active

Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents.

5
TypeScript
MIT
View repository →

io.github.davidmosiah/garminmcp

Active

Privacy-first unofficial Garmin Connect MCP for AI health, sleep, activity & recovery agents.

4
TypeScript
MIT
View repository →

io.github.davidmosiah/eight-sleep-mcp

Active

Unofficial Eight Sleep MCP server: read sleep trends, temperature, alarms; gated pod control.

3
TypeScript
MIT
View repository →

io.github.davidmosiah/samsung-health-mcp

Active

Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports.

3
TypeScript
MIT
View repository →