google-ads-cli

Use when querying Google Ads via CLI — GAQL queries, MCC multi-account operations, campaign management, performance reporting. Covers gaql-cli (Python), mcc-gaql-rs (Rust), and google-ads-mcp (MCP server).

Model	Source
inherit	pack: google-cli

Full Reference

google-ads-cli

Mandatory Announcement — FIRST OUTPUT before anything else:

┏━ 🔧 google-ads-cli ━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ [one-line description of ads operation]          ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Google Ads from terminal — three tools, one skill. GAQL queries, MCC multi-account, campaign management, MCP integration.

Quick Reference

Item	Value
gaql-cli	`pipx install gaql` (Python, interactive REPL + single query)
mcc-gaql-rs	Binary from GitHub releases (Rust, cross-account, NL queries)
google-ads-mcp	`pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp`
Fork	https://github.com/Armadillo-Nation/armadillo-gaql

Tool Selection

Need	Tool
Quick interactive queries	gaql-cli (REPL mode)
Single account, file output	gaql-cli (`-f csv -o file`)
Cross-MCC reporting	mcc-gaql-rs (`--all-linked-child-accounts`)
Stored query library	mcc-gaql-rs (`-q <name>`)
Natural language queries	mcc-gaql-rs (`-n "..."`)
AI agent integration	google-ads-mcp (MCP server)

Reference Index

I want to…	File
Install tools, auth setup, developer token, MCP config	`reference/setup.md`
GAQL syntax, queries, field reference	`reference/gaql.md`
MCC multi-account ops, cross-account reporting	`reference/mcc.md`
Campaign management, performance, budgets	`reference/campaigns.md`

Load only the reference docs relevant to the current task.