v1.0.1 · The only Google Ads plugin on Anthropic's Claude Code marketplace

Meet Buddy — Google Ads inside Claude Code

Opus-powered enterprise Google Ads agent. Live API access. 6 specialized sub-agents. 2 MCP servers. 77 production skills. 7 slash commands. Safety hooks. Anomaly monitor. Built by a practitioner with $350M+ in managed ad spend.

Install in 1 command → View on GitHub
After approval in Anthropic's marketplace
/plugin marketplace add anthropics/claude-plugins-community /plugin install googleadsagent@claude-community
Self-hosted (works right now)
/plugin marketplace add itallstartedwithaidea/claude-googleadsagent /plugin install googleadsagent@claude-googleadsagent
7Agents
77Skills
2MCP Servers
7Commands
$350M+Spend Managed

The only Google Ads plugin in Anthropic's marketplace

While every other "advertising plugin" out there is a thin wrapper around a single skill, Buddy is the production system behind googleadsagent.ai — packaged for Claude Code with everything: agents, MCP servers, skills, commands, hooks, monitors. One install. Real API access. Built by an Anthropic-shipped practitioner who's managed $350M+ in ad spend.

🤖

Buddy is Opus-powered

The flagship agent runs on Claude Opus. He follows the Context Efficiency Protocol (CEP), the Filter-First Architecture, and dollar-based math. Never micros.

agents/buddy.md
🪄

Live Google Ads API

The bundled googleadsagent-mcp server gives the agent read + write access to the live Google Ads API. GAQL queries, mutations, recommendations, the full surface.

PyPI · v1.0.0
🎨

Cloudinary creative tools

The bundled @googleadsagent/ad-creative-mcp server resizes, validates, and optimizes ad creative across 50+ platform specs.

npm · v1.0.0 · bundled
🛡️

Safety hooks built-in

PreToolUse hook validates every GAQL query — no accidental writes from read-only contexts. PostToolUse hook logs every tool call to a local audit trail.

hooks/hooks.json
📡

Background anomaly monitor

Polls every 15 minutes. Surfaces CPA spikes >20%, CTR drops >15%, zero-conversion spend, budget-limited campaigns, disapproved ads — directly into your Claude Code session.

monitors/anomaly-watch.js
📚

77 production skills

Google Ads (16), AI agent engineering (10), Claude mythos (10), software dev (8), security (4), infrastructure (6), productivity (6), web frontend (6), scientific research (8), media creative (3).

skills/

Meet Buddy

Buddy is the same flagship agent live at googleadsagent.ai/tools/auditor, now packaged for Claude Code as a first-class subagent. Same prompt engineering. Same CEP protocol. Same dollar-denominated math. Just inside your terminal instead of a browser tab.

Buddy chat interface
Buddy live at ahmeego.com/tools/auditor/app — the same agent, now inside Claude Code

Buddy doesn't work alone — meet the squad

Buddy dispatches to 6 specialized sub-agents to keep his orchestration context clean and let specialists do specialized work. Each one has its own system prompt, lives at agents/<name>.md, and uses the same MCP servers Buddy does.

Simba
Reporting · Analysis

GAQL composition, multi-dimensional performance reports, anomaly detection. Returns concise summaries — no data dumps.

Nemo
Research · Competitive Intel

Keyword research, competitor ad transparency, Google Trends, search-term mining, external market signals.

Elsa
Optimization · Write Ops

Bulk operations, applying Google's recommendations, change previews, executing approved mutations with safety gates.

Aladdin
Shopping · PMax

Product feed analysis, asset group management, listing groups, brand exclusions, PMax-specific insights.

Moana
Visual Creative

Responsive Display Ads, Demand Gen campaigns, image/video asset uploads, creative previews across IAB sizes.

Baymax
Resize · Format Conversion

Cloudinary-powered resizing to IAB standard sizes, platform-specific formats, video aspect ratio conversion.

How a conversation actually looks

Just talk. Buddy figures out the rest — and dispatches to the right sub-agent when needed. Three real Buddy scenarios cycling below.

claude code · plugin: googleadsagent v1.0.1
you › Hey Buddy, audit my MCC for the last 30 days. Focus on PMax.
buddy › Which account name or ID? And do you want enabled-only?
you › MCC 123-456-7890, enabled only.
buddy › Dispatching to @simba for the data pull...
[google-ads MCP] run_gaql · 12 PMax · 30-day window
[validate-gaql hook] ✓ read-only query, allowed
simba › 12 PMax campaigns · $48,322 spend · 3 budget-limited.
Audit complete — Score: B+
· 3 budget-limited PMax — est. +$11k/mo if uncapped
· 47 disapproved assets across 5 asset groups
· Brand exclusion list missing on 8 campaigns
· Final URL expansion ON across all PMax
you › Apply the top 3 — preview each first.
buddy › Dispatching to @elsa...
[audit-log hook] ✓ 14 mutations logged
you › @aladdin which Shopping product groups are limited by budget?
[google-ads MCP] pmax_listing_groups · 1,247 product groups
aladdin › 18 product groups budget-constrained. Top 5 by potential gain:
1. Saatva — Memory Foam Mattress · 73% IS lost
2. Saatva — Loom & Leaf · 67% IS lost
3. Saatva — Adjustable Bases · 61% IS lost
4. Saatva — Sheets & Bedding · 58% IS lost
5. Saatva — Crib Mattresses · 54% IS lost
you › Show me the asset performance labels for the top group.
aladdin › Reading asset_group_asset.performance_label...
BEST: 4 images · 3 videos · 6 headlines
GOOD: 7 images · 2 videos · 4 headlines
LOW: 12 images · 1 video · 2 headlines · ← retire these
you › Pause the LOW assets, propose 5 replacement images.
buddy › Routing creative replacement to @moana + @baymax...
you › @baymax resize this 1200×628 hero banner for every standard display size.
[ad-creative MCP] cloudinary.upload · received 1.2 MB JPG
baymax › Detected: lodge-bedroom-warmlight.jpg · 1200×628 · 1.4:1
[ad-creative MCP] cloudinary.transform · 12 variants queued
Generated variants:
300×250 · 728×90 · 160×600 · 320×50 · 970×250
300×600 · 336×280 · 468×60 · 234×60 · 120×600
1080×1080 (Meta sq) · 1080×1920 (TikTok 9:16)
baymax › Smart-cropped on focal point (lamp + bed). 12 ready.
you › Upload all 12 to Google Ads under name "Lodge_Warmlight_{size}".
[google-ads MCP] upload_image_assets_batch · 12 items
[validate-gaql hook] ✓ asset mutations confirmed by user
buddy › 12 assets uploaded · resource names returned · ready to link to any RDA / PMax asset group.
you › Link them to the "Spring Lodges" PMax asset group.

↑ click tabs to jump · auto-cycles every 6s · pause-on-hover

77 skills across 10 categories

Skills are model-invoked by default — Claude reads each SKILL.md description and picks the right one. Force-invoke any of them with /googleadsagent:<skill>.

Google Ads

16 skills
  • audit · analysis · write · math · mcp
  • keyword-research · ad-copy-generation
  • budget-optimization · pmax-optimization
  • shopping-ads · audience-targeting
  • conversion-tracking · QS optimization
  • remarketing · competitor analysis
  • landing-page-audit

AI Agent Engineering

10 skills
  • knowledge-base injection
  • entity memory · multi-model routing
  • proactive intelligence · MCP creation
  • parallel orchestration · persistence
  • continuous learning · token opt
  • long-horizon workflows

Claude Mythos

10 skills
  • prompt architecture · context engineering
  • tool mastery · cognitive scaffolding
  • verification loops · self-healing
  • adversarial resilience · agent instinct
  • session archaeology · portability

Software Dev

8 skills
  • code review · TDD · debugging
  • git worktrees · brainstorming
  • subagent-driven dev
  • plan writing · plan executing

Security

4 skills
  • agent security scanning
  • CodeQL / Semgrep
  • sandbox hardening
  • secret protection

Infrastructure

6 skills
  • Cloudflare Workers · CI/CD
  • edge rendering · observability
  • service discovery
  • configuration management

Productivity

6 skills
  • workflow orchestration · batch processing
  • knowledge-base RAG · AI chat studio
  • low-code generation · presets

Web Frontend

6 skills
  • React best practices · React Native
  • view transitions · edge deployment
  • composition patterns · design guidelines

Scientific Research

8 skills
  • data analysis · ML · bioinformatics
  • cheminformatics · geospatial
  • research methodology · scientific writing
  • database lookup

Media Creative

3 skills
  • web asset generation
  • programmatic video
  • ML model integration
7 slash commands
/analyze
/audit
/optimize
/status
/login
/logout
/switch

How to install

Five minutes from zero to your first Buddy conversation.

Make sure you have Claude Code

This plugin runs inside Claude Code 2.x. If you don't have it, install it first. You'll also need uv (for the Python MCP server) and Node 18+ (for the bundled JS server).

curl -LsSf https://astral.sh/uv/install.sh | sh

Add the marketplace

Once we're approved in the official catalog:

/plugin marketplace add anthropics/claude-plugins-community

Or self-hosted (works right now):

/plugin marketplace add itallstartedwithaidea/claude-googleadsagent

Install Buddy

/plugin install googleadsagent@claude-community (or @claude-googleadsagent for self-hosted)

Claude Code clones the repo and the bundled MCP server in one shot. No npm fetch, no external dependency.

Authenticate Google Ads

You'll need 5 env vars: GOOGLE_ADS_DEVELOPER_TOKEN, CLIENT_ID, CLIENT_SECRET, REFRESH_TOKEN, LOGIN_CUSTOMER_ID. Full walkthrough on the wiki.

Or use the hosted OAuth helper at ahmeego.com/tools/auditor to grab a refresh token in 60 seconds.

Reload + talk to Buddy

/reload-plugins then say "Hey Buddy, audit my MCC for the last 30 days." Buddy is the default agent (configured in settings.json), so you don't need to address him explicitly.

Built by an Anthropic-shipped practitioner

I've spent $350M+ on Google Ads across
Groupon, Prudential, GM, Eventbrite, GCU,
Saatva, W.F. Young, NortonLifeLock, Chevrolet,
and Farmers. Buddy is what I built for myself.
github.com/itallstartedwithaidea linkedin · johnmichaelwilliams ahmeego.com googleadsagent.ai substack · weekly

Start shipping

The only Google Ads plugin on Anthropic's Claude Code marketplace. Free. Proprietary. Production-tested.

GitHub → Buddy on Gemini CLI → Docs / Wiki