Connector guide4-minute read17 MCP tools7 languages

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.

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

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

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.

A Google Ads audit in one conversation

Short answer: connect Google Ads to Claude through AnythingMCP, then ask Claude to audit the account. Claude reads the account settings, the daily trend, campaign totals, conversion actions, search terms, keywords and budgets through read-only tools, and reports what looks wrong with the numbers to back it. Nothing in the account is changed; you decide what to do with the findings.

A manual audit means exporting a dozen reports and cross-checking them. Claude can pull each report when it needs it, for any date range, and follow a lead: if the cost per conversion looks too good, it checks the days and the conversion actions before you see the summary.

What we asked

We ran this on our own account, in claude.ai, with the Google Ads connector installed:

With the Google Ads connector: how did the account do in the last 30 days? Spend, conversions, cost per conversion and the main campaigns. Read only, no changes.

What Claude did

StepToolWhy
1gads_list_accessible_customersfind the accounts the user can open
2gads_get_customercurrency and time zone of each account
3gads_campaign_performancetotals per campaign for the 30 days
4gads_list_campaignswhich campaigns are enabled or paused, and why
5gads_account_daily_metricsthe daily trend behind the totals
6gads_conversion_actionswhat is actually being counted as a conversion

Six calls, all reads, well inside the daily quota.

What it found

  • Two accounts with the same name. One had a single paused campaign and no activity all year; Claude said so and used the other one.
  • Totals. Spend, conversions, clicks, CTR and cost per conversion for the 30 days, with the currency named.
  • One campaign did all the work. A Performance Max campaign carried all spend and conversions; the Search campaign was paused.
  • Numbers too good to be true. The cost per conversion was very low for a B2B account. In the daily trend Claude found two short bursts with clicks at about one cent each that produced most of the month's conversions, and a two-day gap where the campaign barely ran.
  • What the conversions were. Almost every conversion was one sign-up action, tracked as a page visit, with a fixed default value. Claude recommended comparing Google's sign-up count with the real sign-ups in the product for those days before trusting the campaign's optimization, because Performance Max optimizes toward whatever the primary conversion counts.

That last point is the one that matters: the campaign looked excellent on the dashboard, and the audit showed why the number could not be taken at face value.

The full audit checklist

The connector's playbook (gads_playbook) gives Claude the queries for each part. Ask for any of these by name:

AreaWhat Claude checksMain tools
Overviewtotals, trend, top campaigns, CPA and ROASgads_account_daily_metrics, gads_campaign_performance
Conversion qualityprimary actions, counting type, value, volume per actiongads_conversion_actions, gads_run_gaql
Wasted spendsearch terms and keywords with cost and no conversionsgads_search_terms, gads_keyword_performance
Negative keywordsrecurring bad terms, existing negatives to avoid duplicatesgads_search_terms, gads_run_gaql
Quality Scorelow scores and the component that drags them downgads_keyword_performance
Budget and rankimpression share lost to budget vs to rankgads_budget_pacing
Adsdisapprovals, ad strength, ad groups with one adgads_ad_performance
Targetingdevice, location (including spend outside targeted countries), hour and weekdaygads_run_gaql
Performance Maxasset groups and search categoriesgads_run_gaql
Changeswho changed what around a dropgads_change_history

Prompts for the next steps

  • "Audit my Google Ads account for the last 30 days using the playbook: overview, conversion quality, wasted spend, budgets and ads. Read only."
  • "Show spend and conversions by country for the Performance Max campaign, and flag countries we do not target."
  • "List search terms with spend and no conversions in the last 90 days and group them into negative keyword themes."
  • "Which keywords have Quality Score 5 or lower, and which component is below average?"
  • "Compare this month with the same period last year, by campaign."

FAQ

Is it safe to let Claude into the ad account? The connector has no write tools, so Claude cannot change campaigns, bids or budgets. For extra safety, authorize it with a Google Ads user that has the Read only role.

How long does it take? The run above took under a minute of tool calls. A full checklist audit is a few minutes and a few dozen API operations.

Does it work for agencies with many accounts? Yes. With a manager account, Claude lists the client accounts and runs the same checks per account; mind the daily quota of your Cloud project (2,880 operations on Explorer access).

Do I need a developer token? No. Since September 2026 the Google Ads API uses your Google Cloud project's access level instead; see Google Ads API access without a developer token.

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 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 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.