Google Ads is Google’s pay-per-click ad platform, and Google publishes a free MCP server for it. MCP is the open standard that lets an AI assistant like Claude or ChatGPT call another product’s tools directly. Once it’s connected, Claude can read last month’s search terms report and point at the queries that burned money.
Guides written as recently as July get step one wrong. They tell you to get a developer token. Google retired developer tokens on September 9, 2026, and tied API access to your Google Cloud project instead. Since October 9, people setting up Google’s server on fresh projects report being refused within a minute, with the reply “The Google Cloud project is only approved for use with test accounts.”
We’d still run Google’s read-only server on your own project, and vet any hosted server before it touches your account. Google’s rewritten developer policy now names MCP servers among the hosted wrappers it prohibits.
- Google ships an official server.
googleads/google-ads-mcpis free, open source and read-only. Its search tool can query 181 resource types, but nothing in it can change a bid or pause a campaign. - The developer token is gone. Since September 9, 2026, access belongs to your Google Cloud project. Explorer access reaches live accounts and allows 2,880 operations a day.
- Some new projects are hitting a wall. Between October 9 and 13, 2026, five users reported Explorer applications refused within a minute. Google’s maintainer says it is being investigated.
- Hosted servers skip the setup, and some can change budgets. Google’s August 31, 2026 policy prohibits MCP servers that only wrap its API, so ask any vendor whose Cloud project carries your requests.
Is there an official Google Ads MCP server?
Yes. Google surveyed developers about an Ads MCP server in July 2025, then released the Google Ads API MCP Server as open source on October 7, 2025. The launch post was blunt. “This initial release is read-only, meaning it can be used for reporting and diagnostics but will not make changes to your account.”
A year on, that still holds. Checked on October 15, 2026, googleads/google-ads-mcp on GitHub is on v0.0.5 from October 9, with 1,043 stars and an Apache 2.0 license. If MCP itself is new to you, our plain explainer covers it without the jargon.
Read from its source, the server offers three tools. By default your client shows each with a category prefix, such as customers_list_accessible_customers.
list_accessible_customers: returns the account IDs your Google login can reach.get_resource_metadata: lists the fields you can select, filter and sort for a resource such ascampaign.search: runs the report. The agent passes fields, a resource and filters, and the server writes the GAQL query. GAQL is Google Ads Query Language, the SQL-like language the API speaks.
The search tool’s description lists 181 resources it can query, from campaign to search_term_view. Google’s integration guide puts the limit in one line. “It cannot modify bids, pause campaigns, or create new assets.”
Read-only lives in the tool list
Google’s OAuth docs name a single scope for the Ads API, adwords, and it covers changes as well as reports. A comment in the server’s own code says Google publishes no read-only scope. So the server is read-only because it offers no write tools, not because of what you signed in with. Point another server at the same sign-in and it can do whatever your Google Ads user role allows.
Writes are coming here too. On June 4, 2026 a Google maintainer said write access is planned, with each write tool switched on or off in a config file. None had shipped by v0.0.5.
No hosted version yet
You run Google’s server yourself, on your machine or on Google Cloud Run. Google’s guide mentions a hosted endpoint pilot for allowlisted participants, but its setup page isn’t public. On October 15, 2026 it returned a 404.
Do you still need a Google Ads developer token?
No. Until September 9, 2026, every Google Ads API call carried a developer token, a 22-character string from the API Center in a Google Ads manager account. Google sunset it that day. Access now belongs to the Google Cloud project that owns your OAuth client. You can still send a token, but Google calls it “optional and ignored by the API servers.” You don’t need a manager account either.
A new project starts on Test access, which only reaches test accounts that never serve ads. Google’s access levels page sets out the ladder.
| Level | Reaches | Daily operations | How you get it |
|---|---|---|---|
| Test | Test accounts only | 15,000 | Automatic when you enable the API |
| Explorer | Live and test accounts | 2,880 on live accounts | Apply in the Cloud Console, reviewed automatically |
| Basic | Live and test accounts | 15,000 | Brand verification, then a review in minutes |
| Standard | Live and test accounts | Unlimited | Manual audit, typically 10 business days |
Explorer is enough for an MCP. A report is one operation, so 2,880 a day is one every 30 seconds, around the clock. Failed requests still count, and Explorer blocks Google’s planning services, Keyword Planner’s ideas included.
The October wall
On paper, Explorer is reviewed automatically. This month, some new projects are being turned away.
Google’s own known issues list says projects on a Google Cloud Free Trial, or with suspended or disabled billing, are being rejected. Google says it has found the root cause and is working on a fix.
Fixing billing doesn’t always help. In issue #133 on Google’s repo, five people describe Explorer refused within a minute between October 9 and 13, 2026, most after moving to paid billing, with no email saying why. On October 13 a Google maintainer replied that the problem “is being investigated.”
If you have a project that made API calls with an approved token in the 90 days before September 9, it inherited that access, so use it. Otherwise contact Google Ads API support and work from a CSV export in the meantime.
How to set up Google Ads MCP in Claude
To connect Google Ads to Claude with Google’s server, you’ll need Python 3.10 or later, pipx and Google’s gcloud CLI. The first step is the one that can stall.
- Get production access: in the Google Cloud Console, enable the Google Ads API, open its Overview page and apply for Explorer.
- Create a Desktop OAuth client in that same project: access follows the project that owns the client. If the consent screen is in Testing, add yourself as a test user.
- Sign in once with gcloud: run
gcloud auth application-default loginwith--client-id-filepointing at the JSON file you downloaded for your OAuth client, and--scopesset tohttps://www.googleapis.com/auth/adwordsandhttps://www.googleapis.com/auth/cloud-platform, comma separated. Copy the credentials path gcloud prints at the end. Google now asks for a passkey at this sign-in, a change that began rolling out on August 5, 2026. It warns a 7-day security delay may apply to a new passkey, so set one up before you start. - Add the server to Claude: one command in Claude Code, or one block in Claude Desktop.
In Claude Code, this command adds the server to all your projects. Claude Code keeps MCP servers in ~/.claude.json or a project’s .mcp.json, not the settings.json file Google’s README points to.
claude mcp add google-ads --scope user \
--env GOOGLE_PROJECT_ID=YOUR_PROJECT_ID \
--env GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON \
-- pipx run --spec \
git+https://github.com/googleads/google-ads-mcp.git \
google-ads-mcp
In Claude Desktop, open Settings, then Developer, then Edit Config. Paste Google’s block from the README into claude_desktop_config.json, with pipx as the command, the same run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp arguments, and your GOOGLE_PROJECT_ID and GOOGLE_APPLICATION_CREDENTIALS as env values. Then restart Claude.
If you reach the account through a manager account, add GOOGLE_ADS_LOGIN_CUSTOMER_ID with the manager’s ID. Since v0.0.4 on September 25, 2026, the agent can also pass it per call.
Google’s README now documents Antigravity and Codex too, each with its own setup. Until a June 30, 2026 rewrite it documented Gemini CLI, which reads this same mcpServers block from ~/.gemini/settings.json.
Ask “what customers do I have access to?” first. It’s a single call, and it proves the sign-in works before you ask for anything bigger. Google’s Analytics MCP server installs the same way, with pipx and Google credentials, and reads your GA4 reports.
Google Ads MCP alternatives: hosted servers
Hosted servers skip the Cloud project, the OAuth client and the wait. You sign in to the vendor, connect Google Ads with your Google login, and paste one URL into your assistant. Prices below were read from each vendor’s own page on October 15, 2026.
| Option | Reads or writes | Starts at |
|---|---|---|
| Google’s google-ads-mcp | Reads only | Free, you host it |
| Adzviser | Reads only | 14-day trial, then $48.99 a month |
| Pipeboard | Reads and writes, new campaigns paused | Free tier, Pro US$29.90 a month |
| Adspirer | Reads and writes, new campaigns paused | Free for 15 tasks a month, Plus $49 a month ($40 billed annually) |
| Markifact | Reads and writes, each write approved | 200 free credits, Pro from $79 a month |
| CData Connect AI | Reads and approved writes | 14-day trial, then $99 a month |
None of the hosted options asks you for a Cloud project, so the October wall doesn’t block you. Start read-only, and add a write-capable server only after checking who holds the access and how changes get approved. Several also cover Meta.
Two general hubs cover Google Ads too. Composio’s toolkit has 36 tools, budget edits included, on a free Hobby tier. Zapier’s MCP can pause or enable a campaign but lists no budget or bid action, and each successful call uses two Zapier tasks. If you already pay for Optmyzr, check its MCP first. Asked whether it changes your account directly, Optmyzr’s answer is “No, the changes happen inside Optmyzr after you review them.”
To add a hosted server to Claude Desktop, go to Customize, then Connectors, then +, then Add custom connector, and paste the vendor’s URL. Pipeboard’s is https://google-ads.mcp.pipeboard.co/ and Adspirer’s is https://mcp.adspirer.com/mcp.
Google Ads MCP for ChatGPT
Use a hosted server that ChatGPT can reach. Custom MCP connectors in ChatGPT depend on your plan, so check yours first. Adspirer has a ChatGPT app, which it says needs Plus, Pro, Business or Enterprise. Google also documents a route for its own server, deployed on Cloud Run with your own OAuth client.
Ask whose Cloud project it uses
On August 31, 2026, Google rewrote its developer policy. An archived copy from August 21 never mentions MCP. Today’s Google Ads Developer Policies name it directly.
The policy prohibits any “third-party hosted interface, secondary API, wrapper service, or MCP server” that “solely replicates, wraps, or re-exposes Google Ads programmatic capabilities as an intermediate layer.” Agencies and advertisers, it adds, must use “their own Google Cloud Platform account and Google Ads access.”
It also says what’s fine. The rule doesn’t restrict “open-source tools where the end-users download the software and connect it to Google Ads using their own access credentials.” That describes Google’s own server on your own project.
Google hasn’t said how it applies this to any named product, and each vendor above adds features of its own. Its August 31 announcement does say the Ads API compliance team is “actively reviewing existing integrations.” So ask before you connect, and use our guide to vetting an MCP server for the rest of the checklist.
What goes wrong
Each of these comes from Google’s docs or a public issue report.
- “Only approved for use with test accounts”: your project is still on Test access. From v25 the API calls it
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. Apply for Explorer, and see the October wall above if you’re refused. - “User doesn’t have permission to access customer”: you reach the account through a manager account. Set the manager’s ID as the login customer ID.
- Sign-ins that expire: an OAuth consent screen left in Testing gets refresh tokens that last 7 days. One user on a Workspace account with session control reports a 503, “Reauthentication is needed”, every 12 to 16 hours.
- Week filters: filter
segments.weekon a date that isn’t a Monday and you getMISALIGNED_DATE_FOR_FILTER. Daily and weekly data only go back 37 months. - Missing Performance Max terms:
search_term_viewleaves out Performance Max. Google points you tocampaign_search_term_viewfor those. - Money in micros: cost comes back as
cost_micros, and one million micros is one unit of your account currency. A value of 12500000 is 12.50, so check the agent divided. - Oversized answers: the search tool has no default row limit, and Claude Code caps MCP output at 25,000 tokens unless you raise it. Ask for a top 25 or 50.
- Failed queries cost quota: a rejected request still counts as an operation. The search tool’s own description tells the agent to look fields up rather than guess.
- A popular community server is stuck:
cohnen/mcp-google-adshas 712 stars but still calls API v19, which Google switched off on February 11, 2026. Seven pull requests to update it sit unmerged. It also still demands a developer token. - Same name, different server: several projects share the name. Google’s is published by
googleads, and its maintainers have fielded bug reports for tools it doesn’t have.
Three prompts to start with
All three only read. If you have more than one account, the agent will ask which one to use.
- Find wasted spend: ask for search terms from the last 30 days that cost money and got zero conversions, the top 25 by cost in your account currency rather than micros, grouped by theme with negative keywords suggested but not added. Skim the GAQL query the server logs the first time. A missing date filter or the wrong resource is easy to spot.
- Check target CPA: for each enabled Search campaign, compare cost per conversion over the last 14 days with its target CPA, and list campaigns more than 20% over target with spend, conversions and the gap.
- Compare week over week: compare last week, Monday to Sunday, with the week before for every enabled campaign, show cost, clicks, conversions and cost per conversion side by side, and flag any change over 25% with the search terms that drove it.
None of these tell you which paid terms your site already ranks for. Google’s paid and organic report gets partway there, and the official server can query it as paid_organic_search_term_view. It needs Search Console linked to Google Ads, holds organic data only from the day you linked, and says nothing about a term’s difficulty or who holds the top spots.
Where ContextBolt fits
ContextBolt is ours, so weigh the bias. ContextBolt SEO is a hosted SEO MCP server that gives your agent keyword volume, difficulty and cost per click, who ranks for a term, the keywords a domain ranks for, and your own Search Console clicks, queries and positions once you connect it. It reads your real position for each paid term from Search Console, or checks the top 10 if you haven’t connected it.
Its figures are estimates from a large keyword index, decision-useful and directionally right. Reading your Search Console data costs no credits. Volume and difficulty cost 1 credit a term, and a top-10 check 1 more, so 20 terms run about 20 to 40 credits.
Next to a Google Ads MCP, the overlap check is one prompt: list your 20 most expensive search terms from the last 30 days with conversions, add your position, volume, difficulty and cost per click for each, and put it in one table, marking terms where you rank in the top 3 and converting terms where you don’t rank.
A term you already rank first for might not need the same bid, or it might, if the ad wins clicks your listing wouldn’t, so test a change before you commit to it. A converting term where you don’t rank, or sit outside the top 10, is a brief for your next article, and our keyword research guide picks up from there. Every lookup saves to your SEO Dashboard. The 7-day free trial includes 100 credits and requires a card. After that it is $35 a month with 1,000 credits. For the organic side with your real clicks and positions, see Google Search Console MCP.