Skip to content
MCP server

Google Ads MCP

Google Ads reports, GAQL queries and confirmed campaign changes from your agent

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI
Runs
Locally
Version
26.11.13
Listing updated
2 days ago

About Google Ads MCP

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

Fourteen tools split ten reads from four admin tools. Reads cover accounts, campaigns, ad groups, ads, keywords, search terms and performance totals, and ads_query runs any read-only Google Ads Query Language SELECT for cuts such as clicks by device or conversions by location. Admin tools create and manage search campaigns, ad groups, responsive search ads and keywords.

Because every admin action can spend money, each one needs confirm: true, and new campaigns, ad groups and ads are created paused. It does not create Performance Max, Shopping, Display or video campaigns, and creating a campaign requires an EU political advertising declaration. Amounts are in micros, which the agent converts.

It is an independent local extension and npm package, not Google's official server. You need your own developer token with approved access, OAuth credentials and a customer ID; a manager account works.

Install

Run in a terminal

claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads API developer token.Required
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.Required
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.Required
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Ads scope.Required
  • GOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) account ID, digits only, when you access accounts through a manager.
  • GOOGLE_ADS_DEFAULT_CUSTOMER_IDAccount used when a tool call names none.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

ads_list_accounts
List reachable customer accounts.
ads_account_info
Account name, currency, time zone and manager status.
ads_campaigns
Campaigns with status, budget and metrics.
ads_ad_groups
Ad groups with metrics.
ads_ads
Ads with headlines, descriptions and metrics.
ads_keywords
Keyword performance.
ads_search_terms
Search terms report.
ads_performance
Account or per-campaign totals for a date range.
ads_query
Run a read-only GAQL query.
ping
Check the server is running.
ads_campaign_admin
Create and manage search campaigns.
ads_ad_group_admin
Create and manage ad groups.
ads_ad_admin
Create and manage responsive search ads.
ads_keyword_admin
Add and manage keywords.

What it does

Read tools
Accounts, campaigns, ad groups, ads, keywords and search terms.
GAQL queries
Run any read-only query for custom breakdowns.
Performance totals
Account totals, or by campaign, for a date range.
Campaign admin
Create search campaigns, pause, enable, remove and change budgets.
Ad and keyword admin
Create responsive search ads and keywords with match types.
Confirmation and paused starts
Changes need confirm: true and new items start paused.

Good for

  • List search terms with spend and no conversions
  • Compare this week with last week by campaign
  • Pause the campaign with the highest cost per conversion
  • Draft a paused campaign for review
  • Switch between client accounts under a manager account

Pricing

Open source

Free, MIT licensed

Prices change. Check renzojohnson.com before you buy.

Google Ads MCP FAQ

Is it Google's official server?

No, it is an independent extension using your own developer token.

Can it spend without asking?

Every admin action needs confirmation and new items are created paused.

Does it cost anything?

The extension is free and MIT licensed; you pay Google for ads as usual.

What do I need first?

A Google Ads account, an approved developer token, OAuth credentials and your customer ID.

Is Google Ads MCP free?

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

How do I add Google Ads MCP 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_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcp

What are the best alternatives to Google Ads MCP?

The closest alternatives to Google Ads MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to Google Ads MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. 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
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data