Google Ads MCP server
MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset performance.
1 stars80 downloads/wk
Reviews
Write oneNobody has reviewed Google Ads yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Google Ads tools (22, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
gads_account_infoGet basic info for the current Google Ads account: name, currency, timezone, manager flag, status.
gads_ad_group_performanceAd group performance with campaign context. Optional campaign_id filter. Default last 28 days, enabled ad groups.
gads_auction_insightsAuction Insights report: impression share, overlap rate, outranking share, top-of-page %, and absolute top % vs competitors. Optional campaign filter.
gads_budget_pacingCost vs budget per campaign for the specified period with utilization percentage. Flags over- and under-pacing campaigns. Default last 28 days.
gads_campaign_assetsAssets linked to campaigns with field type and status. Shows which extensions are active on which campaigns.
gads_campaign_audience_targetingAudiences attached to campaigns with targeting setting (observation vs targeting) and bid modifier. Shows both inclusion and exclusion lists.
gads_campaign_performanceCampaign-level performance: impressions, clicks, CTR, avg CPC, cost, conversions, conv value, CPA, ROAS. Defaults to last 28 days, enabled campaigns, sorted by cost desc.
gads_conversions_by_campaignConversions and conversion value broken down by campaign × conversion action. Sorted by conversions desc. Default last 28 days.
gads_device_performanceClicks, cost, CTR, conversions, and CPA split by MOBILE / DESKTOP / TABLET per campaign. Default last 28 days.
gads_geo_performancePerformance broken down by geographic location (country, region, city). Surfaces top and bottom geo segments by cost and conversions.
gads_impression_shareSearch Impression Share, Lost IS (Budget), and Lost IS (Rank) per campaign. Identifies whether budget or Quality Score/bid is limiting reach.
gads_keyword_performanceKeyword-level performance with match type, quality score, clicks, cost, conversions. Filter by campaign_id or ad_group_id. Default last 28 days, enabled keywords.
gads_list_accountsList all Google Ads customer accounts the authenticated user has access to. Useful for finding customer IDs.
gads_list_assetsList account-level assets: sitelinks, callouts, structured snippets, images, call extensions, and more. Filter by asset type.
gads_list_audiencesList user lists (remarketing audiences, customer match lists) in the account with size, eligibility, and match rate.
gads_list_budgetsAll campaign budgets with daily/total amount, delivery method (STANDARD/ACCELERATED), period, and whether a recommended budget exists.
gads_list_campaignsList campaigns in the account with name, status, channel type, bidding strategy, and date range. Filter by status (default ENABLED).
gads_list_conversion_actionsList all conversion actions configured in the account: name, category, type, whether included in Conversions metric, counting type.
gads_list_rsasList Responsive Search Ads with all headlines, descriptions, Ad Strength rating, and approval status. Filter by campaign or ad group.
gads_rsa_asset_performanceAsset-level performance labels (BEST / GOOD / LOW / PENDING / LEARNING) for RSA headlines and descriptions. Identifies which assets to keep, test, or replace.
gads_run_gaqlwrite actionEscape hatch: run any raw GAQL query against Google Ads. Use when preset tools don't cover the report shape you need. Docs: developers.google.com/google-ads/api/docs/query/overview
gads_search_terms_reportSearch terms that triggered ads (the actual user queries, not your keywords). Essential for finding wasted spend and negative keyword candidates. Default last 28 days.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan13 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 152 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Google Ads compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,273 servers
- Tools
- 22
- the typical server has 7
- Tools that change things
- 5%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,534 servers
- Downloads a week
- 80
- more than 59% of 11,915 servers with a package
What its tools let an agent do: 21 read · 1 change
Install Google Ads in Claude Code, Cursor or VS Code
Runs npx -y @zleventer/google-ads-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add google-ads-mcp -- npx -y @zleventer/google-ads-mcp
What the publisher says
From the Google Ads repository's README, as published. We do not edit it. Read it on GitHub
google-ads-mcp
MCP server for Google Ads — diagnose spend efficiency, impression share, and asset performance from Claude.
22 tools across campaigns, keywords, RSAs, assets, audiences, geo/device splits, impression share, auction insights, and budget pacing — plus a raw GAQL escape hatch. Built for B2B paid search teams and agencies running real diagnosis, not just dashboard-style "list my campaigns" queries.
Why this exists
Most Google Ads MCP servers stop at "list campaigns + basic metrics." This one goes after the questions paid search teams actually ask: which RSA assets are labeled LOW so I can replace them, which keywords burn budget with zero conversions, who am I losing impression share to in auction insights, what's my mobile vs. desktop CPA gap, which campaigns are budget-limited right now. Those are the levers you pull to fix performance — and they're all first-class tools here.
Differentiated from the official googleads/google-ads-mcp: ships RSA asset performance labels, auction insights, impression share analysis, geo/device splits, audience targeting inspection, and budget pacing.
Example prompts
Once installed, ask Claude things like:
- "What's my impression share vs competitors this month? Who am I most often losing to?"
- "Show all RSA assets with LOW performance labels so I can replace them."
- "Which keywords are spending the most with zero conversions in the last 30 days?"
- "What's my mobile vs. desktop CPA difference across all campaigns?"
- "Are any campaigns budget-limited right now? Show Lost IS (Budget)."
- "List my remarketing audiences and tell me which ones are large enough to target in Search."
Demo
🎥 Walkthrough video coming soon — diagnosing wasted spend from Claude in under 60 seconds.
Features
Prerequisites
- Node.js 20+
- A Google Ads Developer Token (apply here)
- OAuth 2.0 credentials (Client ID + Secret) from Google Cloud Console
- A refresh token with https://www.googleapis.com/auth/adwords scope
Environment variables
Usage
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Google Ads: common questions
- Is Google Ads MCP server safe?
- Mostly: it is graded B (72/100). Read the Google Ads safety report
- How do I install Google Ads?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Google Ads need an API key?
- Yes. The registry entry asks for
GOOGLE_ADS_DEVELOPER_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_REFRESH_TOKEN. - Is Google Ads maintained?
- The last commit was 187 days ago (2026-04-29). The latest release is v1.0.1.
- What can I use instead of Google Ads?
- Servers from other publishers that do the same job: AdLoop MCP server.
- How does Google Ads compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,273 servers); tools 22 (the typical server has 7); tools that change things 5% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Google Ads
Same job from other publishers: the closest match first, then the best rated.
- AdLoopGoogle Ads, Reddit Ads, GA4 and Tag Manager in your AI client, with a preview before every change.not reviewedEstablishedA