Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Google Ads in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Google Ads for AI agents: campaign, ad group, ad and keyword performance, search terms, Quality Score, budget pacing and impression share, conversion actions, change history, recommendations, manager (MCC) accounts and any GAQL query. 17 read-only tools, OAuth2.
Try asking
Example prompts for Google Ads
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Google Ads, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
Google Ads + Gemini
Google Ads for AI agents: campaign, ad group, ad and keyword performance, search terms, Quality Score, budget pacing and impression share, conversion actions, change history, recommendations, manager (MCC) accounts and any GAQL query. 17 read-only tools, OAuth2.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Step 1 — Get credentials
This connector reads the Google Ads API (googleads.googleapis.com, v25) with Google Ads Query Language (GAQL): accounts and manager (MCC) hierarchies, campaigns, ad groups, ads, keywords, search terms, budgets and impression share, conversion actions, change history and recommendations. 17 tools, all read-only.
Start with gads_playbook. It costs no API call and maps common questions (account health, wasted spend, negative keywords, Quality Score, budget pacing, period comparison, tracking audit, Performance Max, MCC roll-ups) to the right tools and tested GAQL queries.
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
- Save the file and restart
gemini. - Run
/mcpinside the Gemini CLI —Google Adsshould be listed as available. - Vertex AI Studio: pass
https://cloud.anythingmcp.com/mcpto thetoolsarray of your request with the sameX-API-Keyheader.
Available tools
| Tool | What it does |
|---|---|
gads_playbook | START HERE for any Google Ads question: returns, with NO API call, a router from common questions (account health, wasted spend… |
gads_list_accessible_customers | List the Google Ads accounts the authorised Google user can access directly, as resource names ('customers/1234567890') |
gads_get_customer | Read one Google Ads account's settings: name, currency, time zone (all dates in reports are in this zone), whether it is a manager (MCC) or… |
gads_list_client_accounts | List the accounts under a manager (MCC) account: id, name, depth in the hierarchy, whether each is itself a manager, currency, time zone… |
gads_run_gaql | Run any read-only Google Ads Query Language (GAQL) query against one account: every resource, attribute, segment and metric of the Google… |
gads_query_field_catalog | Look up Google Ads API field metadata (names, category RESOURCE/ATTRIBUTE/SEGMENT/METRIC, data type, enum values, whether selectable… |
gads_account_daily_metrics | Account-level totals per day for a date range: impressions, clicks, cost, conversions, conversion value |
gads_list_campaigns | List the account's campaigns (removed ones excluded) with status, serving status, primary status and its reasons (why a campaign is limited… |
gads_campaign_performance | Campaign performance totals for a date range, one row per campaign, sorted by cost: impressions, clicks, CTR, average CPC, cost… |
gads_ad_group_performance | Ad group performance totals for a date range, one row per ad group with its campaign, sorted by cost |
gads_ad_performance | Ad performance for a date range with the ad itself: type, final URLs, responsive search ad headlines and descriptions, ad strength and… |
gads_keyword_performance | Keyword performance for a date range with match type, status and Quality Score components (quality score 1-10, expected CTR, ad relevance… |
gads_search_terms | The search terms report: what people actually typed before your Search ads showed, with campaign, ad group, whether the term is already… |
gads_budget_pacing | Enabled campaigns with their daily budget, spend in the date range and Search impression share lost to budget and to rank |
gads_conversion_actions | List the account's conversion actions (removed ones excluded): name, type, source, category, status, whether each is a primary goal… |
gads_change_history | Who changed what in the account and when: timestamp, user email, tool used (web UI, API, scripts, Editor), resource type and name… |
gads_recommendations | Google's current optimisation recommendations for the account (budget, bidding, keywords, ads, assets...) with the campaign they apply to… |
FAQ
Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.
Next steps
Was this guide helpful?
