/ Blog
Home Blog Contact Buddy Ads Builder Audit Engine

5 Open-Source Google Ads AI Tools I Just Shipped — MCP, Gemini, Claude Skills, and the Full Stack

John Williams · Senior Paid Media Specialist · $48M+ Managed · Mar 2026
Pull search terms from my top 5 campaigns. Flag anything with $50+ spend and zero conversions.
Running GAQL query across your account... Found 23 search terms burning budget with zero conversions. Total wasted spend: $1,847 in the last 30 days. Here's the breakdown by campaign.
Add the top 10 as negative keywords. Exact match.

Live demo: MCP server, Gemini extension, and Claude Skills in action on a real Google Ads account.

The Problem That Wouldn't Go Away

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 Five Projects

google-ads-mcp

Python MCP Server — 29 Tools

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 · MIT
google-ads-gemini-extension

Gemini CLI Extension — 22 MCP Tools

Batteries-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 · MIT
google-ads-skills

Anthropic Agent Skills — 5 Skills for Claude

Teaches 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.0
google-ads-api-agent

Python Agent — 28 Tools, 6 Sub-Agents

Complete 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 · MIT

And 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 MCP Server — The Foundation Layer

The google-ads-mcp server is the portable core. Install it once, and any MCP-compatible AI client gets live Google Ads access.

pip install git+https://github.com/itallstartedwithaidea/google-ads-mcp.git

With this running, the AI doesn't approximate — it executes real GAQL queries against your account and returns actual data.

CategoryCountExamples
Read9get_campaign_performance, get_search_terms, execute_gaql
Audit7get_auction_insights, get_recommendations, get_impression_share
Write11update_campaign_status, add_negative_keywords, create_campaign
Docs2get_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.

Works with: Claude Desktop, Claude Code, Cursor, Windsurf, OpenAI Agents SDK, LangChain, and any MCP client. The repo includes .mcp.json for auto-discovery and CLAUDE.md for persistent context.

The Gemini CLI Extension — Batteries Included

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.

gemini extensions install https://github.com/itallstartedwithaidea/google-ads-gemini-extension

You're prompted for credentials (stored in your system keychain, not plaintext). Everything else is pre-configured:

Claude Skills — Teaching Claude Google Ads

The newest addition. Google Ads Skills for Claude is an Anthropic Agent Skills package — 5 skills that teach Claude how to be a PPC specialist.

# In Claude Code: /plugin marketplace add itallstartedwithaidea/google-ads-skills /plugin install google-ads-full@google-ads-skills
SkillWhat It DoesAPI Needed?
google-ads-analysisGAQL query patterns, anomaly detection, performance reportingYes (via MCP)
google-ads-audit7-dimension account audit, severity ratings, 30/60/90-day planYes (via MCP)
google-ads-writeCEP safety protocol for mutations — pause, bid, budget, adsYes (via MCP)
google-ads-mathCPA, ROAS, budget projections, impression share opportunityNo
google-ads-mcpMCP server setup, configuration, and troubleshootingSetup 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.

Write Safety — The CEP Protocol

Every write operation across every project uses the same safety model: Confirm → Execute → Post-check.

  1. Confirm — The AI shows exactly what will change (entity, current state, proposed state, risk level) and asks for explicit approval
  2. Execute — Only after you say "confirm" does the mutation run
  3. Post-check — The AI verifies the change took effect and notes how to reverse it

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.

How They Connect

google-ads-skills (Claude Skills) | v google-ads-mcp google-ads-api google-ads-gemini (Python, 29 -agent -extension MCP tools) (Python agent) (Gemini CLI) | | | v v v Google Ads API v22 | v Buddy (prod) googleadsagent.ai

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.

What This Means for Practitioners

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.

Read the full technical write-up on Substack: Two Things I Just Shipped for Google Ads + AI

Get Started

For Claude Users

/plugin marketplace add itallstartedwithaidea/google-ads-skills

Or connect the MCP server for live API access.

For Gemini CLI Users

gemini extensions install https://github.com/itallstartedwithaidea/google-ads-gemini-extension

For Any MCP Client

pip install git+https://github.com/itallstartedwithaidea/google-ads-mcp.git

Works with Cursor, Windsurf, OpenAI Agents SDK, LangChain.

Just Want It Managed?

googleadsagent.ai — Buddy handles everything.

Semantic memory, encrypted credentials, monitoring, billing.

Get a Free Google Ads Audit

Want expert eyes on your account? We'll use these tools to run a comprehensive audit and send you actionable recommendations.

Thank You!

We've received your request. Expect a personalized audit within 48 hours.