Integration · Gemini CLI × Google Ads
Run a Google Ads agent inside Gemini CLI
Gemini CLI ships with MCP support out of the box. NotFair adds Google Ads as a typed tool surface so your Gemini-driven workflows can read live campaign data and propose safe writes.
Connect your Google Ads account
Authorize once at notfair.co — then open Gemini CLI and start asking real questions about your account.
Setup
Connect Gemini CLI in three steps
Gemini CLI configures MCP servers in its settings file. NotFair slots in as one entry.
1. Open Gemini CLI's settings
Edit your Gemini CLI mcp settings file (typically ~/.gemini/settings.json).
2. Add NotFair
Register NotFair under mcpServers.
{ "mcpServers": { "NotFair-GoogleAds": { "httpUrl": "https://notfair.co/api/mcp/google_ads" } } }3. Authorize Google Ads
Visit notfair.co/connect, grant Google Ads access, and your Gemini CLI session has live data.
Capabilities
What Gemini CLI can do with NotFair
Live account context
Performance, search terms, change history, conversion status pulled fresh each prompt.
Typed primitives
No GAQL guesswork — the model uses stable, documented tool calls.
Approval-gated writes
Bids, negatives, budgets, ad copy, campaign state — every write goes through approval.
Audit trail
Every action is logged so you can review or undo later.
Example workflows
Prompts that lead to real account work
Account-wide audit
“Audit my Google Ads account end-to-end. Surface the top 5 issues by spend impact. Cite specific campaigns and search terms.”
Structured audit with cost-weighted prioritization and concrete recommendations.
Search-term cleanup
“Find search terms with >$10 spend and zero conversions in the last 30 days. Propose negatives, grouped by campaign.”
Triaged negative-keyword proposal with safety checks for converter overlap.
Budget pacing review
“Which campaigns ran out of budget yesterday and lost impression share? What's the lost-revenue estimate?”
Budget-constrained campaign report with impression-share-to-budget loss estimates.
Why NotFair for Gemini operators
Gemini's strength is multi-modal reasoning. NotFair gives it the structured Google Ads tool layer it needs to turn that reasoning into real account improvements.
- Typed tools complement Gemini's reasoning model
- Safe writes — no destructive actions without approval
- Operation log makes every change reviewable
- Built to play well with multi-step Gemini agent loops
FAQ
Common questions about using Gemini CLI with Google Ads through NotFair.
Does Gemini CLI handle MCP approval prompts?
Yes. Write tools surface as approval-required steps. NotFair also enforces the approval gate server-side as a defense in depth.
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?
OpenAI Codex CLI + Google Ads
NotFair connects OpenAI's Codex CLI to your live Google Ads account through MCP. Diagnose campaigns, draft optimizations, and approve writes — all from the terminal.
Claude Code + Google Ads
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.
Cursor + Google Ads
NotFair adds Google Ads as an MCP server in Cursor so the agent can pull live campaign data, draft optimizations, and ship approved changes — without you tabbing into the Google Ads UI.