Live demo: MCP server, Gemini extension, and Claude Skills in action on a real Google Ads account.
I've managed Google Ads accounts for over 15 years — enterprise budgets, multi-location franchises, SaaS, ecommerce, lead gen. And for most of that time, "AI-powered Google Ads" has been a UX wrapper on top of the same manually-exported data we've always had. Fancier presentation. Same fundamental limitation.
The AI could describe data you'd already seen. It could not run a query. It could not check what's happening in your search terms right now. It could not pull budget pacing across your MCC at 9pm on a Thursday when something breaks.
The limitation was never the AI. The limitation was that nothing was actually connected.
Two things changed that. MCP (Model Context Protocol) became the standard for AI agents to use external tools — Claude, Cursor, Windsurf, OpenAI's Agents SDK all support it. And Gemini CLI launched an extension ecosystem. The infrastructure for building real AI tooling around Google Ads now exists.
So I built the tools. Five open-source projects that give AI agents genuine, live access to the Google Ads API. Not exports. Not screenshots. Real API calls, real data, your real account.
The foundation. Gives any MCP client (Claude, Cursor, Windsurf, OpenAI) live Google Ads API access. 9 read, 7 audit, 11 write, 2 docs tools. All writes are dry-run by default.
Python · MCP · 29 Tools · MITBatteries-included for Gemini CLI. Node.js MCP server, custom commands, agent skills, audit logging hooks, safety policies, and custom themes. One install command.
Node.js · Gemini CLI · 22 Tools · MITTeaches Claude Google Ads expertise. Campaign analysis, 7-dimension account audit, safe write operations (CEP protocol), PPC math, and MCP server setup. Works in Claude Code, Claude.ai, and the API.
Claude · Agent Skills · Apache 2.0Complete Python agent with ReAct reasoning loop. Deploy as a FastAPI REST API or use as a library. Multi-provider AI support (Claude, GPT, Gemini).
Python · FastAPI · Multi-AI · MITAnd the fifth — Buddy at googleadsagent.ai — is the production system running on Cloudflare. Semantic memory, encrypted BYOK credentials, real-time WebSocket, monitoring, billing, and all the battle scars from running real accounts through it.
The google-ads-mcp server is the portable core. Install it once, and any MCP-compatible AI client gets live Google Ads access.
With this running, the AI doesn't approximate — it executes real GAQL queries against your account and returns actual data.
| Category | Count | Examples |
|---|---|---|
| Read | 9 | get_campaign_performance, get_search_terms, execute_gaql |
| Audit | 7 | get_auction_insights, get_recommendations, get_impression_share |
| Write | 11 | update_campaign_status, add_negative_keywords, create_campaign |
| Docs | 2 | get_gaql_reference, get_workflow_guide |
Every write tool is dry-run by default. Pass confirm=False first to preview what will change. Only confirm=True executes the mutation. This isn't a disclaimer — it's how the code is structured.
.mcp.json for auto-discovery and CLAUDE.md for persistent context.The Gemini CLI extension is the opinionated, all-in-one package. It implements every feature type in the extension spec — the first Google Ads extension to do that.
You're prompted for credentials (stored in your system keychain, not plaintext). Everything else is pre-configured:
/google-ads:analyze, /google-ads:audit, /google-ads:optimizeThe newest addition. Google Ads Skills for Claude is an Anthropic Agent Skills package — 5 skills that teach Claude how to be a PPC specialist.
| Skill | What It Does | API Needed? |
|---|---|---|
google-ads-analysis | GAQL query patterns, anomaly detection, performance reporting | Yes (via MCP) |
google-ads-audit | 7-dimension account audit, severity ratings, 30/60/90-day plan | Yes (via MCP) |
google-ads-write | CEP safety protocol for mutations — pause, bid, budget, ads | Yes (via MCP) |
google-ads-math | CPA, ROAS, budget projections, impression share opportunity | No |
google-ads-mcp | MCP server setup, configuration, and troubleshooting | Setup guide |
Three plugin bundles: google-ads-full (all 5), google-ads-readonly (no write access), and google-ads-mcp-only (just the server config). The wiki has full documentation across 11 pages.
I've submitted a Partner Skill PR to Anthropic's official skills repo to get listed alongside Notion.
Every write operation across every project uses the same safety model: Confirm → Execute → Post-check.
No write operation executes without your explicit approval. New campaigns are always created paused. Batch operations are itemized before confirmation. This protocol is enforced at the server level — not just in skill instructions.
Each project serves a different platform, but they share the same Google Ads expertise and safety protocols. Use whichever matches your AI client — or use all of them.
The keyword era in paid media is ending. Not because keywords stopped mattering — they still route intent — but because the tactical layer of PPC management is being absorbed by automation. Smart Bidding, broad match, Performance Max, AI-generated ad copy. Google is systematically removing the levers that used to differentiate a good account manager from a mediocre one.
The practitioners who matter in three years are the ones who moved up the stack. Who understand the strategy above the automation. Who can structure business problems correctly and interpret what the machines are telling them.
But you can only move up the stack if the tactical layer is actually handled — not by a dashboard, but by an agent that has genuine API access, real data, and a safety model you trust.
That's what these five projects are. They're not demos. They're ported from production systems running real accounts. The GAQL templates, anomaly detection thresholds, write safety architecture — all from managing real budgets and fixing what broke.
/plugin marketplace add itallstartedwithaidea/google-ads-skills
Or connect the MCP server for live API access.
gemini extensions install https://github.com/itallstartedwithaidea/google-ads-gemini-extension
pip install git+https://github.com/itallstartedwithaidea/google-ads-mcp.git
Works with Cursor, Windsurf, OpenAI Agents SDK, LangChain.
googleadsagent.ai — Buddy handles everything.
Semantic memory, encrypted credentials, monitoring, billing.
Want expert eyes on your account? We'll use these tools to run a comprehensive audit and send you actionable recommendations.
We've received your request. Expect a personalized audit within 48 hours.