MCP.Market

Google Ads MCP server

by scalably.io·io.scalably/google-ads-mcp·v1.0.1
No reviews yet

Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.

B80/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

0 stars27 downloads/wk

Reviews

Write one

Nobody has reviewed Google Ads MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Google Ads MCP tools (11, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • google_ads_change_events

    Audit trail: who changed what in the last 30 days.

  • google_ads_change_status

    Lightweight change tracker: last-modified-at timestamps for resources.

  • google_ads_describe_resource

    Schema (fields, metrics, segments) for a GAQL resource.

  • google_ads_keyword_forecast_metrics

    Forecast KPIs (impressions, clicks, cost, conversions) for a proposed keyword plan.

  • google_ads_keyword_historical_metrics

    Historical monthly search-volume + competition metrics for specific keywords.

  • google_ads_keyword_ideas

    Generate keyword ideas with search volume + competition + CPC estimates.

  • google_ads_list_accessible_customers

    List every customer_id the OAuth user has direct access to.

  • google_ads_list_customer_clients

    Walk the MCC (Manager Account) hierarchy and return every child account.

  • google_ads_list_resources

    Return the full catalog of GAQL resources (FROM-able tables).

  • google_ads_querywrite action

    Run a GAQL (Google Ads Query Language) query against a specific customer account.

  • google_ads_recommendations

    Read Google's optimization recommendations for a customer account.

Public scan report

scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Google Ads MCP compares

Against every graded SEO MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 60% of 769 SEO servers
Tools
11
the typical SEO server has 6
Tools that change things
9%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
27
more than 15% of 170 SEO servers with a package

What its tools let an agent do: 10 read · 1 change

Install Google Ads MCP in Claude Code, Cursor or VS Code

claude mcp add google-ads-mcp -- uvx scalably-google-ads-mcp
Add to Cursor

What the publisher says

From the Google Ads MCP repository's README, as published. We do not edit it. Read it on GitHub

Google Ads MCP

Read-only MCP server for the Google Ads API. Eleven tools cover discovery, GAQL reporting, resource schema, recommendations, keyword planning and forecasts, and change history for any account reachable under a manager account (MCC). We run this server in production for every ads client. Read-only is enforced at three layers: no mutate or apply service imports, an SDK method allowlist, and a GAQL-starts-with-SELECT guard.

<!-- mcp-name: io.scalably/google-ads-mcp -->

Install

Claude Code:

claude mcp add google-ads \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
  -e GOOGLE_ADS_CLIENT_ID=your-client-id \
  -e GOOGLE_ADS_CLIENT_SECRET=your-client-secret \
  -e GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \
  -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
  -- uvx scalably-google-ads-mcp

Codex:

codex mcp add google-ads \
  --env GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
  --env GOOGLE_ADS_CLIENT_ID=your-client-id \
  --env GOOGLE_ADS_CLIENT_SECRET=your-client-secret \
  --env GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \
  --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
  -- uvx scalably-google-ads-mcp

Claude Desktop: download google-ads-mcp.mcpb from the latest GitHub release and open it.

Setup

This is the heaviest setup in the gallery: expect up to two days waiting on developer token approval. One set of credentials, rooted at a manager account (MCC), can read any customer account linked under it, so there is no per-client configuration beyond linking an account to the MCC.

  1. Google Ads developer token. Sign in at ads.google.com under your manager account, go to Tools and Settings, API Center, and apply for a developer token. A new token starts on the Explorer access level, which Google grants after a review that can take a few days; discovery, query and recommendation tools work there. Basic access (a separate application) is needed for higher quotas and may be needed for the keyword-planning tools.
  2. Google Cloud OAuth client. In a Google Cloud project, enable the Google Ads API, then create an OAuth client ID of type Desktop app under APIs and Services, Credentials. Note the client ID and client secret, and add the https://www.googleapis.com/auth/adwords scope to the OAuth consent screen.
  3. Refresh token. Generate a refresh token once, as an admin user of the manager account, using Google's oauth2l tool or the generateusercredentials.py example shipped with the google-ads Python library. Save the refresh token; it does not expire from normal use.
  4. Login customer ID. Use the 10-digit customer ID of the manager account itself (no hyphens) as GOOGLEADSLOGINCUSTOMERID. Any client account accepts an invite to link under this manager account in its own Google Ads UI, after which googleadslistcustomerclients sees it.

Tools (11)

Configuration

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Google Ads MCP: common questions

Is Google Ads MCP server safe?
Mostly: it is graded B (80/100). Read the Google Ads MCP safety report
How do I install Google Ads MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Google Ads MCP need an API key?
Yes. The registry entry asks for GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN.
Is Google Ads MCP maintained?
The last commit was 35 days ago (2026-09-30). The latest release is v1.0.1.
What can I use instead of Google Ads MCP?
Servers from other publishers that do the same job: Google Ads Intent MCP server, GoAnyAPI MCP server and MCP Ads MCP server. Compare all Google Ads MCP alternatives.
How does Google Ads MCP compare with other SEO MCP servers?
safety score 80/100 (higher than 60% of 769 SEO servers); tools 11 (the typical SEO server has 6); tools that change things 9% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Google Ads MCP

Same job from other publishers: the closest match first, then the best rated.

All Google Ads MCP alternatives →
  • Google Ads Intent
    Dry-run-first Google Ads search-term intent analyzer and negative-keyword MCP for agents.
    B
  • GoAnyAPI MCP
    GoAnyAPI SEO MCP: traffic, DR, backlinks, keywords, Google/Bing SERP/autocomplete, Ads Transparency.
    A
  • MCP Ads
    Run Google Ads, Meta, TikTok, LinkedIn, GA4 & Search Console from chat. Changes wait for approval.
    A
  • AdCopilot
    Google Ads, GA4, Search Console and Tag Manager for AI assistants. Every change is proposed first.
    A
  • SEO Skill
    Free Google Search Console MCP: your real GSC, Google Analytics and keyword data for AI agents.
    A

More from scalably.io →