Google Ads Manager MCP Server
by aleemhaiderio.github.AleemHaider/google-ads-manager-mcpv1.0.0
Unofficial MCP server for Google Ads: reporting plus safe draft/confirm campaign management.
context tax
queued
security
queued
cold start
queued
freshness
Maintained58d ago
Install Google Ads Manager MCP server
Install in Claude Code
claude mcp add google-ads-manager -e GOOGLE_ADS_CLIENT_ID='<google-ads-client-id>' -e GOOGLE_ADS_CLIENT_SECRET='<google-ads-client-secret>' -e GOOGLE_ADS_DEVELOPER_TOKEN='<google-ads-developer-token>' -e GOOGLE_ADS_REFRESH_TOKEN='<google-ads-refresh-token>' -e GOOGLE_ADS_CUSTOMER_ID='<google-ads-customer-id>' -- npx -y google-ads-manager-mcpInstall in Cursor
{
"mcpServers": {
"google-ads-manager": {
"command": "npx",
"args": [
"-y",
"google-ads-manager-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_CUSTOMER_ID": "<google-ads-customer-id>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"google-ads-manager": {
"command": "npx",
"args": [
"-y",
"google-ads-manager-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_CUSTOMER_ID": "<google-ads-customer-id>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"google-ads-manager": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-ads-manager-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_CUSTOMER_ID": "<google-ads-customer-id>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"google-ads-manager": {
"command": "npx",
"args": [
"-y",
"google-ads-manager-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<google-ads-client-id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google-ads-client-secret>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google-ads-developer-token>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google-ads-refresh-token>",
"GOOGLE_ADS_CUSTOMER_ID": "<google-ads-customer-id>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| GOOGLE_ADS_CLIENT_ID | yes | — | OAuth client ID from a Google Cloud 'Desktop app' credential |
| GOOGLE_ADS_CLIENT_SECRET | yes | yes | OAuth client secret from the same Google Cloud credential |
| GOOGLE_ADS_DEVELOPER_TOKEN | yes | yes | Developer token from Google Ads > Tools & Settings > API Center |
| GOOGLE_ADS_REFRESH_TOKEN | yes | yes | OAuth refresh token, generated by running `npm run auth` |
| GOOGLE_ADS_CUSTOMER_ID | yes | — | The Google Ads account this server manages (10-digit ID, dashes optional) |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | — | — | Manager (MCC) account ID, only needed if GOOGLE_ADS_CUSTOMER_ID is a client account under a manager account |
Freshness
Maintained — last maintenance signal 58d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-13 · 58d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-13 · 58d ago · official registry · v1.0.0
FAQ
›How do I install the Google Ads Manager MCP server in Claude Code?
Run: claude mcp add google-ads-manager -e GOOGLE_ADS_CLIENT_ID='<google-ads-client-id>' -e GOOGLE_ADS_CLIENT_SECRET='<google-ads-client-secret>' -e GOOGLE_ADS_DEVELOPER_TOKEN='<google-ads-developer-token>' -e GOOGLE_ADS_REFRESH_TOKEN='<google-ads-refresh-token>' -e GOOGLE_ADS_CUSTOMER_ID='<google-ads-customer-id>' -- npx -y google-ads-manager-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Google Ads Manager require an API key?
Yes. It expects GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CUSTOMER_ID, of which 3 are secrets.
›Can I use Google Ads Manager as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Google Ads Manager in the official MCP registry?
Yes, as io.github.AleemHaider/google-ads-manager-mcp.
Alternatives to Google Ads Manager
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.