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…
Google Ads Mcp is an MCP project maintained in the zleventer/google-ads-mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.
The documented npm package is google-ads-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CUSTOMER_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| gads_run_gaql | Run any raw GAQL query — escape hatch for custom reports |
| gads_list_accounts | List all accessible Google Ads accounts |
| gads_account_info | Name, currency, timezone, manager flag, status |
| gads_list_campaigns | Campaigns with status, channel type, bidding strategy |
| gads_campaign_performance | Impressions, clicks, CTR, CPC, cost, conversions, CPA, ROAS |
| gads_ad_group_performance | Ad group metrics with campaign context |
| gads_keyword_performance | Keywords with match type, quality score, cost, conversions |
| gads_search_terms_report | Actual user queries that triggered ads — find negatives and opportunities |
| gads_conversions_by_campaign | Conversions × conversion action per campaign |
| gads_list_conversion_actions | All conversion actions with category, type, counting method |
| gads_list_rsas | RSAs with all headlines, descriptions, Ad Strength, approval status |
| gads_rsa_asset_performance | Per-asset performance labels: BEST / GOOD / LOW / PENDING / LEARNING |
| gads_list_assets | Account assets: sitelinks, callouts, structured snippets, images |
| gads_campaign_assets | Assets linked to campaigns with field type |
| gads_list_audiences | User lists (remarketing, customer match) with size and match rate |
| gads_campaign_audience_targeting | Audiences on campaigns with bid modifiers and inclusion/exclusion |
| gads_geo_performance | Performance by country, region, and city |
| gads_device_performance | Cost, conversions, CPA split by MOBILE / DESKTOP / TABLET |
| gads_impression_share | Search IS, Lost IS (Budget), Lost IS (Rank) per campaign |
| gads_auction_insights | Impression share, overlap rate, outranking share vs competitors |
| gads_list_budgets | All budgets: amount, delivery method, period, recommended budget |
| gads_budget_pacing | Cost vs budget per campaign with utilization % |
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
"GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
"GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
"GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN",
"GOOGLE_ADS_CUSTOMER_ID": "1234567890"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| GOOGLE_ADS_DEVELOPER_TOKEN | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_CLIENT_ID | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_CLIENT_SECRET | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_REFRESH_TOKEN | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_CUSTOMER_ID | Declared in the maintainer’s client configuration. | Yes |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Fetches and analyzes content from Reddit, providing access to hot threads and post details.
Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.
Automates LinkedIn interactions and extracts data through browser automation, respecting terms of service and rate limits.
Automates SEO tasks and provides AI-powered optimization by integrating with the Google Ads Keyword Planner API.