googleadsagent

Google Ads Agent — Buddy

The most comprehensive Google Ads + advertising automation plugin for Claude Code. By Ahmeego · itallstartedwithaidea · powered by Buddy

---

What you get

• Buddy — flagship Opus-powered Google Ads enterprise agent with live API access
• 6 specialized sub-agents (Simba, Nemo, Elsa, Aladdin, Moana, Baymax) covering reporting, research, optimization, Shopping/PMax, creative, and creative-innovate
• 2 MCP servers — googleadsagent-mcp (Google Ads API) and @googleadsagent/ad-creative-mcp (Cloudinary-backed creative validation)
• ~77 production skills across Google Ads, AI agent engineering, Claude mythos, software dev, security, infrastructure, productivity, web frontend, scientific research, and media creative
• 7 slash commands — /analyze, /audit, /optimize, /status, /login, /logout, /switch
• Safety hooks — PreToolUse GAQL validation prevents write operations from read-only contexts, PostToolUse audit logging
• Background anomaly monitor — surfaces CPA spikes, CTR drops, and zero-conversion spend in real time
• Buddy as the default agent — settings.json activates Buddy immediately on plugin load

Built by a practitioner with $350M+ in managed ad spend across Google, Meta, Microsoft, and Amazon. Reference architecture is the production system behind ahmeego.com.

---

Install (one command)

Once the plugin is approved in Anthropic's community marketplace:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install googleadsagent@claude-community

Self-hosted install (available immediately)

/plugin marketplace add itallstartedwithaidea/claude-googleadsagent
/plugin install googleadsagent@claude-googleadsagent

Local dev install

git clone https://github.com/itallstartedwithaidea/claude-googleadsagent
claude --plugin-dir ./claude-googleadsagent

---

Authentication

The Google Ads MCP server needs OAuth credentials. Copy .env.example to .env and fill in:

Variable	Where to get it
GOOGLE_ADS_DEVELOPER_TOKEN	Google Ads → Tools → API Center
GOOGLE_ADS_CLIENT_ID	Google Cloud Console → OAuth 2.0 Client IDs
GOOGLE_ADS_CLIENT_SECRET	Same as above
GOOGLE_ADS_REFRESH_TOKEN	Run claude-googleadsagent oauth (see wiki)
GOOGLE_ADS_LOGIN_CUSTOMER_ID	Your MCC account ID (no dashes)

Full walkthrough: Wiki → Authentication Or use the Ahmeego hosted OAuth flow: ahmeego.com/docs/google-ads-auth

---

Quick start

Inside Claude Code after installing the plugin:

# Talk to Buddy directly
> Hey Buddy, audit my Google Ads account 1234567890 for the last 30 days

# Run a slash command
/googleadsagent:audit My MCC, last 30 days, focus on PMax campaigns

# Invoke a sub-agent explicitly
> @simba pull a search-term waste report for campaigns with >$50 spend and zero conversions
> @aladdin which Shopping product groups are limited by budget?
> @baymax resize these display creatives for all standard IAB sizes

# Use a specific skill
/googleadsagent:keyword-research expand my "personal injury lawyer" keyword list with high-intent variants

---

What's in the box

Agents (7)

Agent	Role
Buddy	Flagship Google Ads strategist — orchestrates everything
Simba	Reporting & analysis
Nemo	Research & competitive intelligence
Elsa	Bulk optimization & write ops
Aladdin	Shopping & Performance Max
Moana	Visual ad creative (RDA, Demand Gen)
Baymax	Creative resizing & format conversion

MCP servers (2)