Google Ads MCP is a VS Code extension that lets your AI coding agent read and manage your Google Ads account. You ask for campaign performance, keyword reports, or search terms in plain language, and the agent pulls the numbers straight into your editor. It can also create and pause campaigns, ad groups, ads, and keywords when you tell it to.
It works with eight agents: VS Code Copilot, Claude Code, Cursor, OpenAI Codex, Google Gemini, Windsurf, Continue.dev, and Cline. Install it, run the setup wizard once, and the extension registers itself with every agent it finds.
What you can ask
- “Show me my campaign performance this week”
- “What are my top performing keywords?”
- “Which search terms are triggering my ads?”
- “Show me the ads in my brand campaign”
- “Run a GAQL query for campaign metrics by device”
- “Pause the underperforming campaign”
Ten read tools
| Tool | What it does |
|---|---|
ping |
Check server connectivity |
ads_list_accounts |
List accessible customer accounts |
ads_account_info |
Account name, currency, and timezone |
ads_campaigns |
List campaigns with metrics |
ads_ad_groups |
List ad groups with metrics |
ads_ads |
List ads with headlines and descriptions |
ads_keywords |
Keyword performance report |
ads_search_terms |
Search terms report |
ads_performance |
Account and campaign performance summary |
ads_query |
Run read-only GAQL queries for custom reports |
Four admin tools
Write actions are grouped into four admin tools, one per object type.
| Admin tool | Actions |
|---|---|
| Campaign | Create, update, pause, enable, remove, and change daily budget |
| Ad group | Create, update name or CPC bid, pause, enable, remove |
| Ad | Create a responsive search ad, pause, enable, remove |
| Keyword | Add keywords, pause, enable, remove, change CPC bid |
Every write needs confirmation, and new objects start paused
Because every action here spends real money, this extension is stricter than the others. All admin actions require confirm: true, not just the destructive ones. New campaigns, ad groups, and ads are created in a paused state, so nothing starts spending until you switch it on yourself.
What you need before installing
- A Google Ads account with API access
- A developer token from Google Ads, under Tools and Settings, then API Center
- OAuth credentials from the Google Cloud Console, with the Google Ads API enabled and a Desktop app OAuth client
The setup wizard walks through five steps: auth method, OAuth credentials, developer token, agent selection, and verification. Then set gadsMcp.defaultCustomerId in VS Code settings to your ten-digit customer ID, or pass a customer ID with each request.
Which agents it registers with
| Agent | How it registers |
|---|---|
| VS Code Copilot | VS Code API, automatic |
| Claude Code | ~/.claude.json |
| Cursor | ~/.cursor/mcp.json |
| OpenAI Codex | ~/.codex/config.toml |
| Google Gemini | ~/.gemini/settings.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Continue.dev | ~/.continue/config.yaml |
| Cline | VS Code global storage |
Individual agents can be switched off under Settings by searching for gadsMcp.agents.
Install it
Google Ads MCP is free and MIT licensed.
- Install from the VS Code Marketplace
- Install from Open VSX for VSCodium, Cursor, and Windsurf
It is built on the Model Context Protocol, the open standard for connecting AI models to external tools.
Found a bug or want a tool that is missing? Get in touch.
Related
- Google Workspace MCP, the same idea for Gmail, Calendar, Drive, Docs, and Sheets
- GA4 Analytics MCP, for Google Analytics 4 data
- All contributions