Mcp Gads
Wraps the Google Ads API for natural language queries inside Claude or any MCP client. You get 39 tools out of the box: campaign performance, keyword research via Keyword Planner, search term reports, RSA creative breakdowns, image asset downloads, quality scores, and GAQL query execution for custom pulls. Extended tools cover conversion actions, impression share, audience demographics, and landing page metrics. Write operations (pausing campaigns, updating budgets) are available but off by default. Requires a developer token and OAuth credentials from Google Cloud Console. Ships as an npm package or standalone binary, and the setup script handles the OAuth flow so you don't have to wrestle with refresh tokens manually. Built with Bun and TypeScript.
- GitHub stars
- 1
- tools
- 41
- transport
- STDIO
- last updated
- Mar 23, 2026
Tools
41 toolsPublic tool metadata for what this MCP can expose to an agent.
list_accountsList all accessible Google Ads accounts
List all accessible Google Ads accounts
No parameter schema in public metadata yet.
get_account_currencyGet the currency code for an account
Get the currency code for an account
No parameter schema in public metadata yet.
get_account_hierarchyGet MCC account tree (manager -> client)
Get MCC account tree (manager -> client)
No parameter schema in public metadata yet.
execute_gaql_queryRun any GAQL query (table output)
Run any GAQL query (table output)
No parameter schema in public metadata yet.
run_gaqlRun GAQL with format options (table/json/csv)
Run GAQL with format options (table/json/csv)
No parameter schema in public metadata yet.
get_gaql_helpGAQL reference guide with syntax, resources, and examples
GAQL reference guide with syntax, resources, and examples
No parameter schema in public metadata yet.
list_resourcesList valid GAQL FROM clause resources
List valid GAQL FROM clause resources
No parameter schema in public metadata yet.
get_campaign_performanceCampaign metrics (impressions, clicks, cost, conversions)
Campaign metrics (impressions, clicks, cost, conversions)
No parameter schema in public metadata yet.
get_budget_utilizationBudget amounts vs actual spend
Budget amounts vs actual spend
No parameter schema in public metadata yet.
get_ad_performanceAd-level performance metrics
Ad-level performance metrics
No parameter schema in public metadata yet.
get_ad_creativesRSA headlines, descriptions, final URLs
RSA headlines, descriptions, final URLs
No parameter schema in public metadata yet.
get_image_assetsList image assets with URLs and dimensions
List image assets with URLs and dimensions
No parameter schema in public metadata yet.
download_image_assetDownload a specific image asset to disk
Download a specific image asset to disk
No parameter schema in public metadata yet.
get_asset_usageFind where assets are used (campaigns, ad groups)
Find where assets are used (campaigns, ad groups)
No parameter schema in public metadata yet.
analyze_image_assetsImage asset performance with metrics
Image asset performance with metrics
No parameter schema in public metadata yet.
generate_keyword_ideasKeyword Planner suggestions from seed keywords
Keyword Planner suggestions from seed keywords
No parameter schema in public metadata yet.
get_keyword_volumesHistorical search volume for specific keywords
Historical search volume for specific keywords
No parameter schema in public metadata yet.
get_quality_scoresQuality scores with component breakdown
Quality scores with component breakdown
No parameter schema in public metadata yet.
get_search_termsActual search queries triggering your ads
Actual search queries triggering your ads
No parameter schema in public metadata yet.
get_paid_organic_search_termsPaid vs organic clicks per query (needs Search Console link)
Paid vs organic clicks per query (needs Search Console link)
No parameter schema in public metadata yet.
get_search_term_insightsSearch demand categories — the only view into Performance Max & Demand Gen queries
Search demand categories — the only view into Performance Max & Demand Gen queries
No parameter schema in public metadata yet.
get_geographic_performancePerformance by location
Performance by location
No parameter schema in public metadata yet.
get_device_performancePerformance by device type
Performance by device type
No parameter schema in public metadata yet.
get_recommendationsGoogle's AI optimization suggestions
Google's AI optimization suggestions
No parameter schema in public metadata yet.
get_change_historyRecent account changes
Recent account changes
No parameter schema in public metadata yet.
get_ad_group_performanceAd group metrics with optional campaign filter
Ad group metrics with optional campaign filter
No parameter schema in public metadata yet.
get_conversion_actionsConversion actions with settings and performance
Conversion actions with settings and performance
No parameter schema in public metadata yet.
get_account_summaryQuick dashboard: totals + top 5 campaigns
Quick dashboard: totals + top 5 campaigns
No parameter schema in public metadata yet.
get_impression_shareCompetitive position: impression share and lost IS
Competitive position: impression share and lost IS
No parameter schema in public metadata yet.
get_ad_schedule_performancePerformance by hour or day of week
Performance by hour or day of week
No parameter schema in public metadata yet.
get_audience_performanceDemographics: age range and gender breakdowns
Demographics: age range and gender breakdowns
No parameter schema in public metadata yet.
get_landing_page_performanceLanding page URLs with metrics
Landing page URLs with metrics
No parameter schema in public metadata yet.
get_placement_performanceDisplay/PMax placement details
Display/PMax placement details
No parameter schema in public metadata yet.
get_asset_group_performancePMax asset group metrics and ad strength
PMax asset group metrics and ad strength
No parameter schema in public metadata yet.
get_video_performanceYouTube/video view rates and quartile completion
YouTube/video view rates and quartile completion
No parameter schema in public metadata yet.
get_labelsLabels and their campaign/ad group assignments
Labels and their campaign/ad group assignments
No parameter schema in public metadata yet.
update_campaign_statusPause/enable a campaign
Pause/enable a campaign
No parameter schema in public metadata yet.
update_ad_group_statusPause/enable an ad group
Pause/enable an ad group
No parameter schema in public metadata yet.
update_ad_statusPause/enable an ad
Pause/enable an ad
No parameter schema in public metadata yet.
update_campaign_budgetChange daily budget amount
Change daily budget amount
No parameter schema in public metadata yet.
add_negative_keywordsAdd negative keywords to a campaign
Add negative keywords to a campaign
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
mcp-gads
Google Ads MCP server — query campaigns, keywords, assets & more via natural language.
Built with Bun + TypeScript. Works with Claude, Cursor, and any MCP client.
Quick Start
1. Get Credentials
You need a Google Ads API developer token and OAuth client credentials.
- Download your OAuth client JSON from Google Cloud Console
- Set environment variables:
export GOOGLE_ADS_DEVELOPER_TOKEN=your-token
export GOOGLE_ADS_CREDENTIALS_PATH=./credentials.json
- Run the setup helper to authorize:
npx mcp-gads setup
This opens your browser, completes OAuth, and saves a refresh token.
2. Add to Claude Code
claude mcp add google-ads --scope user --transport stdio \
-e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
-e GOOGLE_ADS_CREDENTIALS_PATH=/path/to/credentials.json \
-- npx -y mcp-gads@latest
Details
- Repository
- github.com/pijusz/mcp-gads
- Category
- Finance & Commerce
- Package
mcp-gads- Transport
- STDIO
- Registry
- MCP registry, active
More from pijusz
Related Finance & Commerce MCP servers
View all
Spresh Mcpprashantbtkl/spresh-mcpSearch Facebook ads, decode competitor creative strategy, and track brand ad history.1stars
Auvikwyre-technology/auvik-mcpMCP server for the Auvik network monitoring API — devices, alerts, statistics, billing.1stars
Gmemyksanjo/gmemPersistent, Solana-aware project memory for AI coding agents. Typed entities + git-aware diffs.1stars
FastMCP seed raise pipeline tracker — syncs from Obsidian CRM, generates meetingadelaidasofia/investor-relations-mcpFastMCP seed raise pipeline tracker — syncs from Obsidian CRM, generates meeting prep, tracks…0stars
Polymarket Wallet Intelligenceaemery13/polymarket-intelClassify Polymarket wallets as human or bot, score their trading edge, read open positions.0stars
AnimeAPIanimeapi-ai/animeapi-mcpAnime image and video generation from $0.003 per image. Pay as you go, no subscription.0stars