Connector guide4-minute read17 MCP tools7 languages

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.

HCBy HelpCode teamUpdated 4 min read Open-source on GitHub

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

claude · 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 Claude 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

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.

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.

Google Ads in Claude

Short answer: install the Google Ads connector on AnythingMCP with an OAuth client from your Google Cloud project, authorize it once, then add AnythingMCP to Claude as a custom connector (Customize → Connectors → Add custom connector, URL https://cloud.anythingmcp.com/mcp). Claude can then read your campaigns, search terms, keywords, budgets, conversions and change history, and answer with your real numbers. It cannot change anything in the account.

Claude has no built-in Google Ads connector. A remote MCP server in between is what makes it work in claude.ai on the web, not only in desktop or coding tools.

Set it up

Step 1: Google Cloud project and OAuth client

  1. In console.cloud.google.com, enable Google Ads API for a project and check its access level on the Google Ads API page. You need Explorer access or higher to read real accounts; a new project starts at Test access. No developer token is needed since September 2026.
  2. Set the OAuth consent screen to Internal (Google Workspace) or External and In production.
  3. Create an OAuth client ID of type Web application with the redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback.

The details, including what each access level allows: Google Ads API access without a developer token.

Step 2: Install Google Ads on AnythingMCP

  1. Create a workspace on AnythingMCP Cloud (7 days free) or use your self-hosted AnythingMCP.
  2. In Marketplace, open Google Ads, click Install and paste the client ID and secret.
  3. On the connector page click Authorize with Provider and sign in with a Google user that can see your ad accounts. A user with the Read only role in Google Ads is enough.

Step 3: Add AnythingMCP to Claude

  1. In Claude, open Customize → Connectors.
  2. Click Add, then Add custom connector.
  3. Enter a name, e.g. Google Ads, and your MCP server URL, then click Add. The shared URL https://cloud.anythingmcp.com/mcp works; the server page in AnythingMCP also shows a URL for a server that exposes only Google Ads.
  4. Click Connect and approve the sign-in to AnythingMCP.

Custom connectors are available on every Claude plan; on Free you can add one. On Team and Enterprise, an owner adds the connector for the organisation. The same connector appears in the Claude desktop app.

Step 4: Ask

Start a new chat and ask about your account, for example "how did my Google Ads do last month?". Claude lists your accounts, picks the right one and calls the report tools on its own. Every tool is read-only, so Claude only asks for approval if your connector settings require it.

What happens when you ask

We asked Claude, in claude.ai, how our own account did in the last 30 days. It called six tools, found that one of two accounts with the same name had been idle all year, reported spend, conversions and cost per conversion for the other, and then went further: the daily numbers showed two bursts of one-cent clicks producing most of the month's conversions, and Claude suggested checking the sign-up conversion before trusting the campaign's optimization. The step-by-step version: Google Ads audit with Claude.

Prompts to try in Claude

  • "Compare my Google Ads spend, conversions and cost per conversion this month with last month, by campaign."
  • "Find search terms that cost more than €20 in the last 30 days without a conversion, and propose negative keywords."
  • "Which keywords have a Quality Score below 5, and is the problem expected CTR, ad relevance or landing page?"
  • "Is any campaign limited by budget? Show lost impression share to budget and to rank."
  • "Which ads are disapproved or have poor ad strength?"
  • "What changed in the account in the last 7 days, and who made the changes?"

Good to know

  • Claude reads money in micros from the API and converts it; the connector tells it to name the account currency.
  • Today's data is partial, and conversions keep arriving for days. Ask for "the last 30 full days ending yesterday" for stable numbers.
  • The OAuth client and the refresh token stay on the AnythingMCP server, encrypted. People on your team connect with their own login and never see them.

Every tool and limit in detail: Google Ads MCP server overview.

FAQ

Does it work on the Claude Free plan? Yes. Free plans can add one custom connector, and AnythingMCP counts as one no matter how many connectors you install on it.

Can Claude pause campaigns or change bids? No. The connector only has read tools.

Does it work in Claude Code too? Yes. Add the same server with claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp --header "X-API-Key: <your MCP API key>".

I manage clients through an MCC. Does that work? Yes. Put the manager's 10-digit id in GOOGLE_ADS_LOGIN_CUSTOMER_ID and ask Claude to list the client accounts first.

Related

Was this guide helpful?

Your Google Ads agent is one click away.

Install the connector, paste the key, prompt Claude. 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 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 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.

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.