Skip to content
MCP server

Google Ads

MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.1
Listing updated
5 days ago

About Google Ads

Google Ads is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset performance.

Install

Run in a terminal

claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' -- npx -y @zleventer/google-ads-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}

Configuration

  • GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads developer token (apply at https://developers.google.com/google-ads/api/docs/get-started/dev-token)Required
  • GOOGLE_ADS_CLIENT_IDOAuth 2.0 client ID from Google Cloud ConsoleRequired
  • GOOGLE_ADS_CLIENT_SECRETOAuth 2.0 client secret from Google Cloud ConsoleRequired
  • GOOGLE_ADS_REFRESH_TOKENOAuth 2.0 refresh token with https://www.googleapis.com/auth/adwords scopeRequired
  • GOOGLE_ADS_CUSTOMER_IDDefault Google Ads customer ID (numeric, no dashes). Can be overridden per tool call.Required
  • GOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) account ID — required only if accessing accounts under an MCC

Pricing

Open source

Google Ads FAQ

Is Google Ads free?

Yes. Google Ads is open source, so you can use and self-host it for free.

How do I add Google Ads to Claude Code?

Run this command in your terminal: claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' -- npx -y @zleventer/google-ads-mcp

What are the best alternatives to Google Ads?

The closest alternatives to Google Ads are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to Google Ads

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO