MCP Google Ads
Multi-account Google Ads MCP: campaigns, keywords, search terms, and ad performance.
Connector by Ayo-Fam · 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/ayo-fam-mcp-google-ads
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 · 1 write · 0 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 10
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
compare_periodsget_account_summaryget_ad_performanceget_campaign_performanceget_keyword_performancelist_accountslist_campaignslist_customerssearch_terms_report
Write 1 · Create, change, send or run things.
set_default_account
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GOOGLE_ADS_DEVELOPER_TOKEN
Other settings (environment variables or headers).
GOOGLE_ADS_ACCOUNTS_CONFIG
Tools (10)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
compare_periodsCompare performance between two date ranges. Args: customer_id: Google Ads customer ID period1_start / period1_end: First period (YYYY-MM-DD) period2_start / period2_end: Second period to compare against breakdown: 'campaign' or 'account' level comparison account: Named account from config
get_account_summaryGet top-level spend and conversion totals for an account. Args: customer_id: Google Ads customer ID (e.g. '123-456-7890' or '1234567890') start_date: YYYY-MM-DD end_date: YYYY-MM-DD account: Named account from config (uses default if omitted)
get_ad_performanceGet ad-level performance (headlines, descriptions, CTR, conversions). Args: customer_id: Google Ads customer ID start_date / end_date: YYYY-MM-DD campaign_id: Filter to specific campaign (optional) row_limit: Ads to return (default 25) account: Named account from config
get_campaign_performanceGet campaign performance metrics for a date range. Args: customer_id: Google Ads customer ID start_date: YYYY-MM-DD end_date: YYYY-MM-DD campaign_id: Filter to a specific campaign ID (optional) account: Named account from config
get_keyword_performanceGet keyword-level performance including quality scores. Args: customer_id: Google Ads customer ID start_date / end_date: YYYY-MM-DD campaign_id: Filter to a specific campaign (optional) row_limit: Number of keywords to return (default 50, max 1000) account: Named account from config
list_accountsList all configured Google Ads accounts and which is the current default.
list_campaignsList campaigns for an account. Args: customer_id: Google Ads customer ID status: Filter by status — ENABLED, PAUSED, REMOVED (default: ENABLED and PAUSED) account: Named account from config
list_customersList all accessible Google Ads customer accounts. If customer_id is provided, lists child accounts under that MCC. Otherwise lists all accessible accounts for this login.
search_terms_reportGet actual search terms that triggered your ads. Args: customer_id: Google Ads customer ID start_date / end_date: YYYY-MM-DD campaign_id: Filter to specific campaign (optional) row_limit: Rows to return (default 50, max 1000) account: Named account from config
set_default_accountSet the default account used when no account is specified in other tools.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 27
- Last commit
- Oct 24, 2026 (4 days ago)
- Last release
- Jun 30, 2026 (4 months ago)
- Last package publish
- Jun 30, 2026 (4 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.Ayo-Fam/mcp-google-ads- Version
- 0.1.0
- Auth
- API key
- Packages
- pypi mcp-google-ads-multi
- License
- MIT
- Repository
- github.com/apexradius/mcp-google-ads
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from Ayo-Fam
- 0.495score
MCP Cloudflare DNS
Ayo-Fam
Cloudflare DNS MCP server: manage zones, records, cache purge, and page rules.
ConnectorAFreshness: ALocal↓ 33/wkClaude Code +5 - 0.495score
MCP Search Console
Ayo-Fam
Multi-account Google Search Console MCP: analytics, URL inspection, sitemaps across named accounts.
ConnectorAFreshness: ALocal↓ 27/wkClaude Code +5
Cite this page
MCP Google Ads. Agent Mart. https://agentmart.dev/connectors/ayo-fam-mcp-google-ads (last updated 2026-10-25)