Connector guide4-minute read17 MCP tools7 languages

Google Ads API Without a Developer Token: What Changed in September 2026

Google retired Google Ads API developer tokens on 9 September 2026. Access now belongs to your Google Cloud project: Test, Explorer, Basic and Standard, and how to get each.

HCBy HelpCode teamUpdated 4 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

any ai client · Google Ads
How did our Google Ads account do in the last 30 days? Spend, conversions, cost per conversion and the main campaigns. Read only.
AI
Callinggads_list_accessible_customersgads_campaign_performancegads_account_daily_metricsgads_conversion_actions
One Performance Max campaign carried all spend and conversions; the Search campaign is paused. The cost per conversion looks too good for B2B: two short bursts of clicks at about one cent produced most of the month's conversions, and almost all of them are one sign-up action tracked as a page visit. Compare those days with real sign-ups before trusting the campaign's optimization.
gads_playbookgads_campaign_performancegads_search_termsgads_keyword_performancegads_budget_pacinggads_run_gaql+ more
  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Real prompts that work after a 4-minute setup.

Drop these into your AI client once the connector is installed. Tools listed below each prompt are auto-called by the agent.

“List the search terms from the last 30 days that cost money and never converted, grouped into negative keyword ideas.”
gads_search_termsgads_run_gaql
“Which keywords have a Quality Score of 5 or lower, and which component is below average?”
gads_keyword_performance
“Are my Search campaigns losing impression share to budget or to rank?”
gads_budget_pacing
“Who changed bids or budgets in the account last week?”
gads_change_history

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.

Start free trial

Summary

Google retired Google Ads API developer tokens on 9 September 2026. Access now belongs to your Google Cloud project: Test, Explorer, Basic and Standard, and how to get each.

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.

Google Ads · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

Developer tokens are gone

Short answer: since 9 September 2026 the Google Ads API no longer needs a developer token. Access is granted to your Google Cloud project, at one of four access levels (Test, Explorer, Basic, Standard), and you request it on the project's Google Ads API page in the Cloud console. You no longer need a Google Ads manager (MCC) account to use the API. You can still send the developer-token header; Google ignores it.

Google's developer token page says it directly: developer tokens were sunset on 9 September 2026, and existing access levels were transferred to Cloud projects based on recent API activity. Applications made through the API Center of a manager account are no longer processed.

Before and after

Until September 2026Since 9 September 2026
What identifies your appdeveloper token from a manager account's API Centeryour Google Cloud project
Manager (MCC) accountrequired to get a tokenonly to manage several accounts
Where you applyAPI Center in Google AdsGoogle Ads API page in the Cloud console
developer-token headerrequired on every calloptional, ignored
Quotaper developer tokenper Cloud project
OAuthuser credentialsunchanged: user credentials, scope adwords

The access levels

LevelAccountsOperations per dayHow you get it
Testtest accounts only15,000default for a new project
Explorertest and production2,880 on production, 15,000 on testapply in the Cloud console; often granted automatically, no brand verification
Basictest and production15,000apply after brand verification of the project; reviewed in minutes
Standardtest and productionunlimited (per-service rate limits apply)apply; manual review of about 10 business days

With Test access, a call to a real account fails with CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. That is the error most people hit first after the change: the project works, the OAuth works, but the level is still Test.

Explorer is enough to read your own accounts or a handful of client accounts. A report such as "campaign performance last month" is one operation; an AI agent answering a question usually makes two to eight.

How to get access now

  1. Open console.cloud.google.com, pick or create a project, then APIs & Services → Library and enable Google Ads API.
  2. Open the Google Ads API page of the project. It shows the current access level; expand Upgrade access level and apply for Explorer (or Basic, after brand verification).
  3. Create an OAuth client ID under APIs & Services → Credentials, and set the OAuth consent screen to In production (in Testing mode refresh tokens expire after 7 days).
  4. Authorize with a Google user that has access to the ad accounts. The adwords scope is the only one; it is not read-only, so give that user the role it needs and no more.

What this means for existing tools

Scripts, CLIs and MCP servers written before September 2026 usually ask for a developer token and a manager account. They keep working if they also send OAuth credentials from a project that has access, because the token header is ignored. But their setup instructions now send people through steps that no longer exist, and a new user who creates a token in the API Center gets nothing out of it.

Things to update in your own setup:

  • Stop asking for GOOGLE_ADS_DEVELOPER_TOKEN; keep the OAuth client ID, secret and refresh token.
  • Make sure the OAuth client belongs to a Cloud project with Explorer access or higher.
  • Keep login-customer-id only for access through a manager account.
  • Remember that the quota now belongs to the Cloud project. Several tools sharing one OAuth client share the quota.

Use it from Claude or ChatGPT

The Google Ads connector on AnythingMCP was built for the new model: it asks only for an OAuth client ID and secret (and optionally a manager id), you authorize it once in the browser, and Claude, ChatGPT, Cursor or Gemini can read your campaigns, search terms, Quality Score, budgets and conversions. It is read-only and needs no developer token.

FAQ

My tool still asks for a developer token. What do I enter? Anything, or leave it empty if the tool allows it: Google ignores the header. What matters is that the OAuth client comes from a Cloud project with access.

Do I still need a manager (MCC) account? Only to manage several accounts through one login. For your own account you can call the API directly.

Which access level do I need to read my own account? Explorer. Test access only reaches test accounts.

Is the quota per user or per project? Per Google Cloud project, over a sliding 24-hour window.

Where is this documented? On Google's developer token and access levels pages.

Related

Was this guide helpful?

Your Google Ads agent is one click away.

Install the connector, paste the key, prompt your AI client. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect Google Ads to ChatGPT: Campaign Data via MCP

Add Google Ads to ChatGPT as a developer-mode app: ChatGPT reads campaigns, search terms, Quality Score and budgets from your account. Read-only, no developer token.

Connectors

How to Connect Google Ads to Claude: Custom Connector in 15 Minutes

Add Google Ads to claude.ai and Claude Desktop as a custom connector: Claude reads campaigns, search terms, Quality Score and budgets. Read-only, no developer token.

Connectors

How to Connect Google Ads to Cursor — via MCP

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.

Connectors

How to Connect Google Ads to Gemini — via MCP

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.

Connectors

Google Ads Audit with Claude: A Tested Recipe for Your Own Account

Audit a Google Ads account with Claude in minutes: spend, conversion quality, wasted search terms, Quality Score, budgets and tracking, straight from the API.

Connectors

Google Ads MCP Server: Connect Google Ads to Claude, ChatGPT and Any Agent

Ask Claude or ChatGPT about your Google Ads: campaigns, search terms, Quality Score, budgets, conversions. Read-only, no developer token, set up in 15 minutes.