Integration · Claude Code × Google Ads

Run a Google Ads agent inside Claude Code

NotFair connects Claude Code to your live Google Ads account through MCP. Ask Claude Code what's wasting spend, get a diff of recommended writes, and approve each change from your terminal.

Supported

One CLI command to register NotFair as an MCP server in Claude Code

Live account context — campaigns, search terms, change history, conversion status

Write tools gated behind explicit approval, every action logged for audit

Connect your Google Ads account

Authorize once at notfair.co — then open Claude Code and start asking real questions about your account.

Connect Google Ads

Setup

Connect Claude Code in three steps

Setup takes under two minutes — one shell command, then OAuth into Google Ads through the NotFair web app.

1. Register NotFair as an MCP server
Add NotFair to Claude Code's MCP config from your terminal.
```
claude mcp add NotFair-GoogleAds --transport http https://notfair.co/api/mcp/google_ads
```
2. Authorize Google Ads
Open notfair.co/connect, sign in, and grant Google Ads access. Tokens are scoped to read + propose; writes still require approval.
3. Start a session
Inside any Claude Code workspace, ask: "Audit my Google Ads account and tell me the top three wasted-spend issues." Claude Code will call NotFair's read tools and return a structured diagnosis.

Capabilities

What Claude Code can do with NotFair

Read live campaign data

Performance, search terms, change history, conversion tracking status, impression share — pulled fresh on every prompt.

Diagnose wasted spend

Surfaces high-spend search terms with zero conversions, structural issues, and broken landing pages.

Approval-gated writes

Negatives, bids, budgets, ad copy, campaign state — every mutation goes through an explicit approval step.

Full audit trail

Every write is logged with operation_id, user_id, and undo metadata so you can reverse changes later.

Example workflows

Prompts that lead to real account work

Wasted-spend triage

“Find the five search terms last 30 days with the most spend and zero conversions across all campaigns. Group them and propose negative keywords I should approve.”

Claude Code returns a ranked list with cost, conversion count, and a draft negative-keyword set you can approve in-terminal.

Pre-budget-increase audit

“Before I raise budget on campaign X by 50%, audit its structure, landing page status, conversion setup, and impression share. Flag anything that would waste the new budget.”

A structured pre-flight report so you don't pour money into a structurally broken campaign.

Change-history review

“What changed in this account in the last 7 days, by whom, and what was the performance impact?”

Pulls Google's change history plus NotFair's own operation log and correlates with performance deltas.

Why NotFair instead of a free Google Ads MCP server

Free Google Ads MCP servers exist, but they're thin GAQL wrappers that hand the agent a raw API and hope for the best. NotFair is the connection plus the safety layer — typed tools, freshness metadata, undo, approval gates, and operation provenance.

Typed tools, not raw GAQL — the agent doesn't have to learn an undocumented query language
Snapshot freshness metadata so the agent knows when data is stale
Approval and undo for every write — not a one-way door into your real account
Operation log linking each write to the user/agent that authored it

FAQ

Common questions about using Claude Code with Google Ads through NotFair.

Does NotFair work with Claude Code's plan mode and subagents?

Yes. NotFair tools are visible to plan-mode and to spawned subagents, so a planning agent can propose the diagnosis and a separate executor subagent can apply approved writes.

Can I scope NotFair to one Google Ads account?

Yes. Each OAuth connection is scoped to the account(s) you authorized. You can revoke or re-scope from notfair.co/manage-ads-accounts.

Is NotFair safe to use on a real Google Ads account?

Yes. NotFair separates read tools from write tools. Diagnostic queries run freely, but every write — bid change, negative keyword, ad copy, campaign state — is approval-gated and logged with full provenance so you can audit exactly what the agent did.

How much does NotFair cost?

Free during open beta. NotFair plans to keep a generous free tier for solo operators and a usage-priced plan for teams managing multiple accounts. See /pricing for current limits.

Is NotFair an official Google or Anthropic product?

No. NotFair is an independent product built on the Model Context Protocol (MCP) standard and the Google Ads API. MCP is Anthropic's open protocol for connecting AI clients to external tools; NotFair is one focused entirely on Google Ads.

Other integrations

Switching clients, or curious how this compares?