The only Google Ads extension on Google's Gemini CLI marketplace

Buddy for the Gemini CLI

Production Google Ads commands and skills, ported into Google's Gemini CLI extension format. GAQL queries, account audits, optimization recommendations, safety hooks — straight from your terminal. The same Buddy that lives on Claude Code, packaged for Gemini.

Install in 1 command → View on GitHub

Install

gemini extension install itallstartedwithaidea/google-ads-gemini-extension

Or clone + link locally

git clone https://github.com/itallstartedwithaidea/google-ads-gemini-extension gemini extension link ./google-ads-gemini-extension

7Slash Commands

2Skills

2Hooks

28API Actions

$350M+Spend Managed

One Buddy, two terminals

We ship the same Buddy on both Anthropic Claude Code and Google's Gemini CLI — the only Google Ads tools available on either marketplace. Same operating principles. Same dollar-based math. Same Filter-First Architecture. Pick the agent you already use, get the same enterprise-grade Google Ads workflows.

🪐

Native Gemini extension

Built as a first-class gemini-extension.json package. Installs via gemini extension install like any other CLI extension.

gemini-extension.json

⚡

7 slash commands

/analyze, /audit, /optimize, /status, /login, /logout, /switch. Production-tested workflows from googleadsagent.ai.

commands/google-ads/

🪄

Live Google Ads API

28 API actions including GAQL composition, mutation services, asset uploads, recommendations, and asset group management for Performance Max.

server.js · v22 API

🛡️

Safety hooks built in

BeforeTool hook validates every GAQL query to block accidental writes from read-only contexts. AfterTool hook logs every API call for audit.

hooks/hooks.json

🧠

Two model-invoked skills

google-ads-agent — the core Buddy persona ported to Gemini. security-auditor — scans for unsafe operations before they fire.

skills/

🌐

7 languages

README localized into English, Spanish, French, Korean, Dutch, Russian, Chinese. Same Buddy, multilingual onboarding.

README.{md,es,fr,ko,nl,ru,zh}.md

Meet Buddy — Gemini edition

Same Buddy you'll find at googleadsagent.ai/tools/auditor and now on Claude Code — ported to Gemini CLI without losing the personality, the operating principles, or the production polish.

Buddy on the web (ahmeego.com/tools/auditor) — the same agent now talks back from your Gemini CLI.

How a session actually looks

Inside Gemini CLI. Real GAQL. Real account. Real dollars. Three Buddy scenarios cycling below.

gemini cli · extension: google-ads v1.0.0

you › /audit MCC 123-456-7890, last 30 days, focus on PMax

[google-ads/audit.toml] dispatching to Buddy...

[run_gaql] 12 PMax campaigns · 30-day window

[BeforeTool · validate-gaql] ✓ read-only query, allowed

12 PMax campaigns · total spend $48,322

3 budget-limited campaigns — $11k/mo opportunity

Top 5 issues:

· 47 disapproved assets across 5 asset groups

· Brand exclusion list missing on 8 campaigns

· Final URL expansion ON across all PMax

· 2 conversion actions not optimization-eligible

· Quality Score <7 on 14 keywords carrying $4k/mo

you › /optimize Apply the top 3 — preview first

[AfterTool · log-tool-call] ✓ logged to ~/.gemini/google-ads.audit.log

you › /analyze expand my "personal injury lawyer Atlanta" seed list with high-intent variants

[google-ads/analyze.toml] dispatching to Buddy...

[keyword_plan_idea_service] generating ideas...

Found 847 ideas. Top high-intent variants by avg-monthly searches:

· "best personal injury lawyer atlanta" · 5,400/mo · LOW comp

· "atlanta car accident attorney free consult" · 3,600/mo · MED

· "no win no fee injury lawyer near me" · 2,900/mo · LOW

· "atlanta truck accident lawyer" · 1,900/mo · HIGH ROI sig

· "slip and fall attorney atlanta ga" · 1,300/mo · LOW

you › Add the top 12 to "Atlanta - Search - Brand+" with phrase + exact match.

[BeforeTool · validate-gaql] ✓ write op confirmed by user

[ad_group_criterion.mutate] creating 24 keywords...

Done. 24 keywords added. Default match-type strategy applied (phrase + exact only).

Suggested next: review search-term report in 7 days for negative additions.

you › /optimize show me Google recommendations for MCC 123-456-7890, top 10 by impact

[google-ads/optimize.toml] dispatching to Buddy...

[recommendation_service.list] reading 47 active recommendations...

Top 10 by impact (sorted by est_metrics.cost_micros delta):

1. ADD_ASSET_TO_AG → +$4,200/mo · 3 missing video assets

2. RAISE_BUDGET → +$3,100/mo · "Saatva-Mattress-PMax"

3. KEYWORD_MATCH_TYPE → +$2,400/mo · 6 broad→exact swaps

4. USE_BROAD_MATCH → +$1,800/mo · tCPA, audience signals strong

5. ADD_NEG_KEYWORD → -$1,200/mo waste · "free", "diy"

6-10. CALLOUT, SITELINK, RSA_HEADLINE adds (~$3k combined)

you › Apply #1, #2, #5. Show me a preview before each.

[BeforeTool · validate-gaql] ✓ write mutations confirmed

[recommendation_service.apply] 3 mutations · preview generated

Net impact: +$8,500/mo at current ROAS. Applied ✓

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

How to install

Three minutes from zero to your first audit.

Install Gemini CLI

This extension runs inside Google's Gemini CLI. If you don't have it, install via the gcloud CLI.

gcloud components install gemini

Install the extension

gemini extension install itallstartedwithaidea/google-ads-gemini-extension

Or clone + link for local dev:

git clone https://github.com/itallstartedwithaidea/google-ads-gemini-extension

gemini extension link ./google-ads-gemini-extension

Authenticate Google Ads

Same OAuth flow as Claude Code: GOOGLE_ADS_DEVELOPER_TOKEN, CLIENT_ID, CLIENT_SECRET, REFRESH_TOKEN, LOGIN_CUSTOMER_ID. Or use the hosted helper at ahmeego.com/tools/auditor.

Start auditing

gemini then /audit MCC 123-456-7890, last 30 days. Buddy will ask follow-ups under the Context Efficiency Protocol, then return a scored audit with prioritized recommendations.