MCP.Market

Google Ads MCP server

by ZLeventer·io.github.ZLeventer/google-ads-mcp·v1.0.1·1 stars

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

B72/100grade B
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

1 stars80 downloads/wk

Reviews

Write one

Nobody 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 posts

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

  • gads_account_info

    Get basic info for the current Google Ads account: name, currency, timezone, manager flag, status.

  • gads_ad_group_performance

    Ad group performance with campaign context. Optional campaign_id filter. Default last 28 days, enabled ad groups.

  • gads_auction_insights

    Auction Insights report: impression share, overlap rate, outranking share, top-of-page %, and absolute top % vs competitors. Optional campaign filter.

  • gads_budget_pacing

    Cost vs budget per campaign for the specified period with utilization percentage. Flags over- and under-pacing campaigns. Default last 28 days.

  • gads_campaign_assets

    Assets linked to campaigns with field type and status. Shows which extensions are active on which campaigns.

  • gads_campaign_audience_targeting

    Audiences attached to campaigns with targeting setting (observation vs targeting) and bid modifier. Shows both inclusion and exclusion lists.

  • gads_campaign_performance

    Campaign-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_campaign

    Conversions and conversion value broken down by campaign × conversion action. Sorted by conversions desc. Default last 28 days.

  • gads_device_performance

    Clicks, cost, CTR, conversions, and CPA split by MOBILE / DESKTOP / TABLET per campaign. Default last 28 days.

  • gads_geo_performance

    Performance broken down by geographic location (country, region, city). Surfaces top and bottom geo segments by cost and conversions.

  • gads_impression_share

    Search Impression Share, Lost IS (Budget), and Lost IS (Rank) per campaign. Identifies whether budget or Quality Score/bid is limiting reach.

  • gads_keyword_performance

    Keyword-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_accounts

    List all Google Ads customer accounts the authenticated user has access to. Useful for finding customer IDs.

  • gads_list_assets

    List account-level assets: sitelinks, callouts, structured snippets, images, call extensions, and more. Filter by asset type.

  • gads_list_audiences

    List user lists (remarketing audiences, customer match lists) in the account with size, eligibility, and match rate.

  • gads_list_budgets

    All campaign budgets with daily/total amount, delivery method (STANDARD/ACCELERATED), period, and whether a recommended budget exists.

  • gads_list_campaigns

    List campaigns in the account with name, status, channel type, bidding strategy, and date range. Filter by status (default ENABLED).

  • gads_list_conversion_actions

    List all conversion actions configured in the account: name, category, type, whether included in Conversions metric, counting type.

  • gads_list_rsas

    List Responsive Search Ads with all headlines, descriptions, Ad Strength rating, and approval status. Filter by campaign or ad group.

  • gads_rsa_asset_performance

    Asset-level performance labels (BEST / GOOD / LOW / PENDING / LEARNING) for RSA headlines and descriptions. Identifies which assets to keep, test, or replace.

  • gads_run_gaqlwrite action

    Escape 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_report

    Search 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

no findings
  • 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
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

  • AdLoop
    Google Ads, Reddit Ads, GA4 and Tag Manager in your AI client, with a preview before every change.
    A

More from ZLeventer →