Google Ads

google-ads-mcp

MCP server for Google Ads — diagnose spend efficiency, impression share, and asset performance from Claude.

22 tools across campaigns, keywords, RSAs, assets, audiences, geo/device splits, impression share, auction insights, and budget pacing — plus a raw GAQL escape hatch. Built for B2B paid search teams and agencies running real diagnosis, not just dashboard-style "list my campaigns" queries.

Why this exists

Most Google Ads MCP servers stop at "list campaigns + basic metrics." This one goes after the questions paid search teams actually ask: *which RSA assets are labeled LOW so I can replace them*, *which keywords burn budget with zero conversions*, *who am I losing impression share to in auction insights*, *what's my mobile vs. desktop CPA gap*, *which campaigns are budget-limited right now*. Those are the levers you pull to fix performance — and they're all first-class tools here.

Differentiated from the official googleads/google-ads-mcp: ships RSA asset performance labels, auction insights, impression share analysis, geo/device splits, audience targeting inspection, and budget pacing.

Example prompts

Once installed, ask Claude things like:

• *"What's my impression share vs competitors this month? Who am I most often losing to?"*
• *"Show all RSA assets with LOW performance labels so I can replace them."*
• *"Which keywords are spending the most with zero conversions in the last 30 days?"*
• *"What's my mobile vs. desktop CPA difference across all campaigns?"*
• *"Are any campaigns budget-limited right now? Show Lost IS (Budget)."*
• *"List my remarketing audiences and tell me which ones are large enough to target in Search."*

Demo

🎥 *Walkthrough video coming soon — diagnosing wasted spend from Claude in under 60 seconds.*

Features

Prerequisites

• Node.js 20+
• A Google Ads Developer Token (apply here)
• OAuth 2.0 credentials (Client ID + Secret) from Google Cloud Console
• A refresh token with https://www.googleapis.com/auth/adwords scope

Environment variables

Usage

Claude Desktop (claude_desktop_config.json)

{

"mcpServers": { "google-ads": { "command": "npx", "args": ["-y", "google-ads-mcp"], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN", "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID", "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN", "GOOGLE_ADS_CUSTOMER_ID": "1234567890" } } } }

Claude Code

{

"mcpServers": { "google-ads": { "command": "node", "args": ["/path/to/google-ads-mcp/dist/index.js"], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN", "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID", "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN", "GOOGLE_ADS_CUSTOMER_ID": "1234567890" } } } }

Cursor (~/.cursor/mcp.json)

{

"mcpServers": { "google-ads": { "command": "npx", "args": ["-y", "google-ads-mcp"], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN", "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID", "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN", "GOOGLE_ADS_CUSTOMER_ID": "1234567890" } } } }

Docker

docker build -t google-ads-mcp .

docker run --rm \ -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_TOKEN \ -e GOOGLE_ADS_CLIENT_ID=YOUR_CLIENT_ID \ -e GOOGLE_ADS_CLIENT_SECRET=YOUR_CLIENT_SECRET \ -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \ -e GOOGLE_ADS_CUSTOMER_ID=1234567890 \ google-ads-mcp

Tools reference

Build from source

git clone https://github.com/ZLeventer/google-ads-mcp.git

cd google-ads-mcp npm install npm run build

License

MIT — Copyright (c) 2026 Zach Leventer