mcp-google-ads
Integrates with Google Autocomplete to generate keyword suggestions from real search queries, including A–Z variations, question-style keywords, and place-biased local intent.
Provides tools for keyword research, location lookup, account listing, read-only GAQL queries, and search terms reports using the Google Ads API. Supports Explorer access for keyword suggestions and Basic access for volume, CPC, and forecast metrics.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-google-ads
A Google Ads MCP server that works with Explorer API access.
Status: v0.1.0 — Explorer tools live and tested against a real Google Ads account. Roadmap: docs/PLAN.md.
Why this one is different
Most Google Ads / Keyword Planner MCP servers are built on KeywordPlanIdeaService.
Google only allows those methods from Basic access upward, and Basic now requires
brand verification of your Google Cloud project. With a freshly approved Explorer
access they fail with:
This method is not allowed for use with explorer access. Please apply for basic or standard access.This server is designed for Explorer access from day one. It only uses methods we verified to work on Explorer (see docs/API_ACCESS.md), combined with Google Autocomplete, so you get useful keyword research today. When you get Basic access, flip one variable and the volume/CPC/forecast tools appear.
Typical Keyword Planner MCP | mcp-google-ads | |
Works on Explorer access | ❌ | ✅ |
Keyword suggestions | Basic only | ✅ Explorer (Ads keyword themes + Autocomplete) |
Question-style keywords | — | ✅ |
Local intent (city / state) without a geo filter | — | ✅ place-biased variants |
Location lookup | — | ✅ |
Read-only GAQL reports / search terms | — | ✅ |
Search volume, CPC, forecast | Basic | ✅ with Basic ( |
Claude web login (OAuth, no config files) | Usually stdio only | ✅ |
Developer token required | Yes | No (2026 access model) |
Related MCP server: Google Ads MCP
Features
Remote MCP over Streamable HTTP, ready for Claude web, Desktop, mobile and Claude Code.
Built-in OAuth 2.1 with dynamic client registration: add the URL in Claude, click Connect, paste your access key. No tokens to copy.
Read-only by design: never modifies your Google Ads accounts.
Quota-aware: daily operations budget and response cache for Explorer's 2,880 ops/day.
Dockerized, non-root, read-only filesystem, Traefik-ready.
Tools
Tool | Access level | What it does |
| Explorer | Keyword suggestions from Google Ads |
| none | Real searches from Google Autocomplete (A–Z, questions, places) |
| Explorer | Both sources merged, ranked by agreement; optional |
| Explorer | Location IDs for targeting |
| Explorer | Accounts under your manager account |
| Explorer | Read-only GAQL queries |
| Explorer | Real search terms from your campaigns |
| Explorer | Diagnostics, quota used, token health |
| Basic | Ideas with volume, competition, bids |
| Basic | 12-month search volume |
| Basic | Impressions, clicks, cost |
Full specs: docs/TOOLS.md.
Quick start
git clone https://github.com/diegorenatob/mcp-google-ads && cd mcp-google-ads
cp .env.example .env && chmod 600 .env # fill in the values (see docs/GOOGLE_ADS_SETUP.md)
npm ci && npm run google:auth # one-time Google sign-in
mkdir -p data && sudo chown 1000:1000 data # container runs as non-root
docker compose up -d --build
npm run test:e2e -- --url https://<your-domain> # runs the exact OAuth flow Claude usesThen in Claude: Customize → Connectors → Add custom connector →
https://<your-domain>/mcp → Connect → enter your access key (MCP_ACCESS_KEY).
Details: docs/CLAUDE_WEB.md.
Documentation
Doc | Contents |
Phases, acceptance criteria, risks | |
Components, OAuth flow, source layout | |
Tool inputs/outputs and error messages | |
Tested Explorer vs Basic capability matrix | |
Cloud project, accounts, refresh token | |
Connecting from Claude web / Code | |
Docker + Traefik deployment | |
Secret handling for a public repo, runtime security |
Security
Secrets live only in .env on your server; the repository ships .env.example with
placeholders. See docs/SECURITY.md.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Ask Claude about your Google Ads: campaign performance, wasted search terms, GAQL reports.
Manage Google Ads from ChatGPT, Claude or any MCP client. Sign in with OAuth or use an API key.
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
SEO research, Search Console, GA4 and PPC tools for Claude and ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to your Google Ads account, allowing you to analyze and manage campaigns, ad groups, and keywords using natural language.MIT
- AlicenseNot gradedqualityCmaintenanceEnables natural-language analysis and management of Google Ads accounts, campaigns, keywords, budgets, and performance metrics through Claude.MIT
- AlicenseBqualityCmaintenanceEnables Claude and other MCP-capable assistants to monitor and manage Google Ads accounts by pulling performance reports, running GAQL queries, adjusting budgets, pausing or enabling campaigns, adding keywords and negative keywords, and creating campaigns and ads, with preview and read-only safety controls.31Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables LLMs and AI agents to query Google Ads accounts, inspect resource metadata, list accessible customers, and retrieve reporting metrics, segments, discovery documents, and release notes via the Google Ads API.Apache 2.0