Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.
MCPpedia last refreshed this data
io.scalably/google-ads-mcp is an MCP server that google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools. Its tool list has not been published yet over stdio, requires no API key, and scores 87/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"io-scalably-google-ads-mcp": {
"args": [
"scalably-google-ads-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
uvx 'scalably-google-ads-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked scalably-google-ads-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in marketing
Search Console, Google Analytics and keyword data for your AI agent.
DataForSEO API modelcontextprotocol server
Newsletters where you pay for the emails you send, not for dormant subscribers, at a fraction of the price of beehiiv and the like. Open source: self-host it, or use mailcheap.ai.
X/Twitter automation MCP: scrape, post, schedule, analyze, engage. No API key required.
MCP Security Weekly
Get CVE alerts and security updates for io.scalably/google-ads-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Read-only MCP server for the Google Ads API. Eleven tools cover discovery, GAQL reporting, resource schema, recommendations, keyword planning and forecasts, and change history for any account reachable under a manager account (MCC). We run this server in production for every ads client. Read-only is enforced at three layers: no mutate or apply service imports, an SDK method allowlist, and a GAQL-starts-with-SELECT guard.
Claude Code:
claude mcp add google-ads \
-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_LOGIN_CUSTOMER_ID=1234567890 \
-- uvx scalably-google-ads-mcp
Codex:
codex mcp add google-ads \
--env GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
--env GOOGLE_ADS_CLIENT_ID=your-client-id \
--env GOOGLE_ADS_CLIENT_SECRET=your-client-secret \
--env GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \
--env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
-- uvx scalably-google-ads-mcp
Claude Desktop: download google-ads-mcp.mcpb from the latest GitHub release and open it.
This is the heaviest setup in the gallery: expect up to two days waiting on developer token approval. One set of credentials, rooted at a manager account (MCC), can read any customer account linked under it, so there is no per-client configuration beyond linking an account to the MCC.
https://www.googleapis.com/auth/adwords scope to the OAuth consent screen.oauth2l tool or the generate_user_credentials.py example shipped with the google-ads Python library. Save the refresh token; it does not expire from normal use.GOOGLE_ADS_LOGIN_CUSTOMER_ID. Any client account accepts an invite to link under this manager account in its own Google Ads UI, after which google_ads_list_customer_clients sees it.| Tool | What it does |
|---|---|
google_ads_list_accessible_customers | List every customer_id the OAuth user has direct access to |
google_ads_list_customer_clients | Walk the MCC hierarchy and return every child account |
google_ads_query | Run a GAQL query against a specific customer account |
google_ads_describe_resource | Schema (fields, metrics, segments) for a GAQL resource |
google_ads_list_resources | Return the full catalog of GAQL resources |
google_ads_recommendations | Read Google's optimization recommendations for a customer account |
google_ads_keyword_ideas | Generate keyword ideas with search volume, competition and CPC estimates |
google_ads_keyword_historical_metrics | Historical monthly search-volume and competition metrics for specific keywords |
google_ads_keyword_forecast_metrics | Forecast KPIs for a proposed keyword plan |
google_ads_change_events | Audit trail of who changed what, last 30 days |
google_ads_change_status | Lightweight last-modified change tracker per resource |
| Variable | Required | Purpose |
|---|