Google Ads
MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset performance.
Connector by ZLeventer · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/zleventer-google-ads-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 9 read · 3 write · 0 delete · 10 not yet classified
- Secrets
- 4 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 22
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
gads_account_infogads_list_accountsgads_list_assetsgads_list_audiencesgads_list_budgetsgads_list_campaignsgads_list_conversion_actionsgads_list_rsasgads_search_terms_report
Write 3 · Create, change, send or run things.
gads_device_performancegads_impression_sharegads_run_gaql
Not yet classified 10 · We could not tell from the name and description.
gads_ad_group_performancegads_auction_insightsgads_budget_pacinggads_campaign_assetsgads_campaign_audience_targetinggads_campaign_performancegads_conversions_by_campaigngads_geo_performancegads_keyword_performancegads_rsa_asset_performance
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GOOGLE_ADS_CLIENT_IDGOOGLE_ADS_CLIENT_SECRETGOOGLE_ADS_DEVELOPER_TOKENGOOGLE_ADS_REFRESH_TOKEN
Other settings (environment variables or headers).
GOOGLE_ADS_CUSTOMER_IDGOOGLE_ADS_LOGIN_CUSTOMER_ID
Tools (22)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
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.
Show 7 more tools
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_gaqlEscape 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.
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Last commit
- Apr 29, 2026 (6 months ago)
- Last release
- Apr 26, 2026 (6 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.ZLeventer/google-ads-mcp- Version
- 1.0.1
- Auth
- API key
- Packages
- npm @zleventer/google-ads-mcp
- License
- MIT
- Repository
- github.com/ZLeventer/google-ads-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from ZLeventer
- 0.410score
LinkedIn Campaign Manager
ZLeventer
MCP server for LinkedIn Ads — 19 read-only tools for campaigns, performance, and Lead Gen Forms.
ConnectorDFreshness: DLocalClaude Code +5 - 0.410score
Marketo
ZLeventer
MCP server for Marketo — 32 tools for leads, programs, emails, forms, lists, and bulk export.
ConnectorDFreshness: DLocalClaude Code +5 - 0.410score
Salesforce Marketing
ZLeventer
MCP server for Salesforce — 47 tools for leads, campaigns, pipeline, attribution, and reporting.
ConnectorDFreshness: DLocalClaude Code +5
Cite this page
Google Ads MCP server. Agent Mart. https://agentmart.dev/connectors/zleventer-google-ads-mcp (last updated 2026-10-24)