Google Ads MCP Server
by scalably-ioio.scalably/google-ads-mcpv1.0.1
Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.
context tax
queued
security
queued
cold start
queued
freshness
Active31d ago
Install Google Ads MCP server
Install in Claude Code
claude mcp add scalably-google-ads -e GOOGLE_ADS_DEVELOPER_TOKEN='<google-ads-developer-token>' -e GOOGLE_ADS_CLIENT_ID='<google-ads-client-id>' -e GOOGLE_ADS_CLIENT_SECRET='<google-ads-client-secret>' -e GOOGLE_ADS_REFRESH_TOKEN='<google-ads-refresh-token>' -e GOOGLE_ADS_LOGIN_CUSTOMER_ID='<google-ads-login-customer-id>' -- uvx scalably-google-ads-mcpInstall in Cursor
{
"mcpServers": {
"scalably-google-ads": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google-ads-login-customer-id>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"scalably-google-ads": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google-ads-login-customer-id>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"scalably-google-ads": {
"type": "stdio",
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google-ads-login-customer-id>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"scalably-google-ads": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google-ads-login-customer-id>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| GOOGLE_ADS_DEVELOPER_TOKEN | yes | yes | Google Ads API developer token from the Ads API Center |
| GOOGLE_ADS_CLIENT_ID | yes | — | OAuth2 client_id for a Desktop-app credential |
| GOOGLE_ADS_CLIENT_SECRET | yes | yes | OAuth2 client_secret paired with the client_id |
| GOOGLE_ADS_REFRESH_TOKEN | yes | yes | Long-lived OAuth2 refresh_token for the adwords scope |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | yes | — | 10-digit customer ID of the manager account (MCC) |
| GOOGLE_ADS_API_VERSION | — | — | Google Ads API version to target, default set by the server |
| GOOGLE_ADS_LOG_LEVEL | — | — | Log level, default WARNING |
| GOOGLE_ADS_USE_PROTO_PLUS | — | — | Use proto-plus message types, default true |
Freshness
Active — last maintenance signal 31d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-09 · 31d ago · GitHub
Latest release
2026-09-09 · 31d ago · GitHub · v1.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-09 · 31d ago · official registry · v1.0.1
FAQ
›How do I install the Google Ads MCP server in Claude Code?
Run: claude mcp add scalably-google-ads -e GOOGLE_ADS_DEVELOPER_TOKEN='<google-ads-developer-token>' -e GOOGLE_ADS_CLIENT_ID='<google-ads-client-id>' -e GOOGLE_ADS_CLIENT_SECRET='<google-ads-client-secret>' -e GOOGLE_ADS_REFRESH_TOKEN='<google-ads-refresh-token>' -e GOOGLE_ADS_LOGIN_CUSTOMER_ID='<google-ads-login-customer-id>' -- uvx scalably-google-ads-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Google Ads require an API key?
Yes. It expects GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID, of which 3 are secrets.
›Can I use Google Ads as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Google Ads in the official MCP registry?
Yes, as io.scalably/google-ads-mcp.
Alternatives to Google Ads
Other crm & marketing MCP servers.
AtlassianActiveSearch, read, create and manage Confluence and Jira content, supporting Confluence Cloud, Jira Cloud and Jira Server/Data Center.
Google Ads + Meta Ads + SEO/GEOActiveGoogle Ads, Meta Ads, SEO, GEO & GA4 MCP by Ryze AI - audits, reports, keywords, Search Console.
AdsAgentDeprecatedGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Meta AdsActiveRemote MCP server to interact with Meta Ads API - access, analyze, and manage Facebook, Instagram, and other Meta platforms advertising campaigns.
SEO MonsterActiveLocal-first SEO MCP: track AI citations, Search Console, GA4, PageSpeed, Cloudflare, IndexNow, CrUX.
Facebook AdsMaintainedMCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.