Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
GOOGLE_ADS_DEVELOPER_TOKEN=<secret> GOOGLE_ADS_CLIENT_ID=<value> GOOGLE_ADS_CLIENT_SECRET=<secret> GOOGLE_ADS_LOGIN_CUSTOMER_ID=<value> GOOGLE_ADS_REDIRECT_URI=<value> GOOGLE_ADS_TOKEN_PATH=<value> GOOGLE_ADS_PRIVACY_MODE=<value> GOOGLE_ADS_ALLOW_MUTATIONS=<value> GOOGLE_ADS_CACHE=<value> GOOGLE_ADS_CACHE_PATH=<value> GOOGLE_ADS_CACHE_TTL_SECONDS=<value> GOOGLE_ADS_NO_RETRY=<value> claude mcp add davidmosiah-google-ads-mcp-unofficial -- npx -y google-ads-mcp-unofficial@0.1.3In einem Terminal ausführen.
{ "mcpServers": { "davidmosiah-google-ads-mcp-unofficial": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "<secret>", "GOOGLE_ADS_CLIENT_ID": "<value>", "GOOGLE_ADS_CLIENT_SECRET": "<secret>", "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<value>", "GOOGLE_ADS_REDIRECT_URI": "<value>", "GOOGLE_ADS_TOKEN_PATH": "<value>", "GOOGLE_ADS_PRIVACY_MODE": "<value>", "GOOGLE_ADS_ALLOW_MUTATIONS": "<value>", "GOOGLE_ADS_CACHE": "<value>", "GOOGLE_ADS_CACHE_PATH": "<value>", "GOOGLE_ADS_CACHE_TTL_SECONDS": "<value>", "GOOGLE_ADS_NO_RETRY": "<value>" } } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenUnofficial Model Context Protocol server that lets AI agents read, analyze, and (gated) act on a Google Ads account — pause keywords, set bids, adjust budgets — without leaving your stack.
Unofficial. Not affiliated with Google. This is a local-first MCP server that speaks the Google Ads REST API directly. It does NOT include automated financial-account changes beyond what the Google Ads API allows. Always review proposed changes before enabling GOOGLE_ADS_ALLOW_MUTATIONS.
Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:
npx -y google-ads-mcp-unofficial --http
# GET http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp (sessionless)
Env: GOOGLE_ADS_MCP_HOST, GOOGLE_ADS_MCP_PORT, GOOGLE_ADS_MCP_TRANSPORT=http.
npx -y google-ads-mcp-unofficial setup
The setup wizard collects your developer token + OAuth client, writes ~/.google-ads-mcp/config.json (chmod 600), then walks you through the OAuth dance via a local callback at http://127.0.0.1:3000/callback.
Verify:
npx -y google-ads-mcp-unofficial doctor
Then add it to your agent (Claude Desktop, Cursor, Hermes, OpenClaw, Codex — see examples below).
22 tools across 6 categories.
Full tool reference: see AGENTS.md.
npx -y google-ads-mcp-unofficial setup [--allow-mutations] [--client hermes|claude|cursor|...]
What it does:
~/.google-ads-mcp/config.json with chmod 600.claude_desktop_config.json on macOS; writes a Hermes block and skill file for --client hermes).--no-auth) by opening Google's consent screen and listening on 127.0.0.1:3000.Mutations are off by default.
--allow-mutationsenables write tools. ASK THE USER before turning this on — it lets agents change campaigns, bids, budgets, and pause/resume keywords.
This MCP requires two credentials:
https://www.googleapis.com/auth/adwords.⚠️ Refresh token gotcha: Google only returns a
refresh_tokenon first consent or after you revoke the prior grant at https://myaccount.google.com/permissions. Ourauthflow usesprompt=consentto maximize the chance Google returns one — but if your code-exchange response is missingrefresh_token, the tool will tell you to revoke and retry.
Pass privacy_mode per call to override the default per response.
Redaction matrix:
Default: mutations are DISABLED. Six tools are gated:
google_ads_pause_keyword / google_ads_resume_keywordgoogle_ads_set_keyword_bid_microsgoogle_ads_set_campaign_budget_microsgoogle_ads_pause_campaign / google_ads_resume_campaignIf an agent calls any of them without GOOGLE_ADS_ALLOW_MUTATIONS enabled, it gets:
Error: Write tools are disabled. To enable: re-run `google-ads-mcp-server setup --allow-mutations`
or enable GOOGLE_ADS_ALLOW_MUTATIONS. ASK THE USER BEFORE TURNING THIS ON — it lets agents
change campaigns, bids, budgets, and pause/resume keywords.
Even with the env enabled, every mutation requires explicit_user_intent: true in the per-call arguments. And every mutation is logged to stderr with the resource name:
[google-ads-mcp] MUTATION pause_keyword {"resource_name":"customers/1234567890/adGroupCriteria/999~111222333"}
Read SECURITY.md for the threat model.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": ["-y", "google-ads-mcp-unofficial"]
}
}
}
Then restart Claude Desktop.
~/.cursor/mcp.json (or your IDE equivalent):
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": ["-y", "[email protected]"]
}
}
}
# ~/.hermes/config.yaml
mcp_servers:
google-ads:
command: npx
args:
- -y
- [email protected]
timeout: 120
connect_timeout: 60
sampling:
enabled: false
Then /reload-mcp (do NOT restart the gateway for normal data access).
~/.openclaw/mcp.servers.json:
{
"google-ads": {
"command": "npx",
"args": ["-y", "[email protected]"]
}
}
See examples/codex.toml for the equivalent TOML block.
// Agent asks: "How did my Google Ads do yesterday?"
{
"name": "google_ads_daily_report",
"arguments": {
"customer_id": "1234567890",
"cpc_alert_threshold": 0.15
}
}
Returns markdown with yesterday + 7d + 30d aggregates. If yesterday's CPC exceeds 0.15, the output gets an ALERT banner.
{
"name": "google_ads_find_waste",
"arguments": {
"customer_id": "1234567890",
"date_range": "LAST_30_DAYS",
"min_clicks": 5,
"min_cost_micros": 200000,
"zero_conversions_only": true
}
}
Returns a ranked list of keywords matching "spent ≥ $0.20 with ≥5 clicks and 0 conversions" — but never pauses them.
After the user confirms:
{
"name": "google_ads_pause_keyword",
"arguments": {
"customer_id": "1234567890",
"ad_group_id": "999",
"criterion_id": "111222333",
"explicit_user_intent": true
}
}
Unofficial integration. Not affiliated with Google. This MCP does not include automated financial-account changes beyond what the Google Ads REST API allows. Always review proposed changes before enabling GOOGLE_ADS_ALLOW_MUTATIONS. The author is not responsible for budget overruns, paused campaigns, or any other consequences of automated changes to your Google Ads account.
MIT-licensed.
Same package, two doors. MCP registers tools on stdio/HTTP. The skill can drive the same tools through the CLI when the client has no MCP:
npx -y google-ads-mcp-unofficial call google_ads_connection_status --json '{}'
Copy skill/SKILL.md into your agent skills dir.
Unofficial MCP server for Google Ads — campaign management, keyword/bid optimization, budget control, daily reports. Local-first, OAuth-based, mutations gated by env var.
{ "mcpServers": { "davidmosiah-google-ads-mcp-unofficial": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "<secret>", "GOOGLE_ADS_CLIENT_ID": "<value>", "GOOGLE_ADS_CLIENT_SECRET": "<secret>", "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<value>", "GOOGLE_ADS_REDIRECT_URI": "<value>", "GOOGLE_ADS_TOKEN_PATH": "<value>", "GOOGLE_ADS_PRIVACY_MODE": "<value>", "GOOGLE_ADS_ALLOW_MUTATIONS": "<value>", "GOOGLE_ADS_CACHE": "<value>", "GOOGLE_ADS_CACHE_PATH": "<value>", "GOOGLE_ADS_CACHE_TTL_SECONDS": "<value>", "GOOGLE_ADS_NO_RETRY": "<value>" } } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Der Herausgeber nennt diese Umgebungsvariablen: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_LOGIN_CUSTOMER_ID, GOOGLE_ADS_REDIRECT_URI, GOOGLE_ADS_TOKEN_PATH, GOOGLE_ADS_PRIVACY_MODE, GOOGLE_ADS_ALLOW_MUTATIONS, GOOGLE_ADS_CACHE, GOOGLE_ADS_CACHE_PATH, GOOGLE_ADS_CACHE_TTL_SECONDS, GOOGLE_ADS_NO_RETRY.
Google Ads MCP Unofficial läuft lokal über stdio.
Zuletzt geprüft: 2026-10-27. Unofficial MCP server for Google Ads — campaign management, keyword/bid optimization, budget control, daily reports. Local-first, OAuth-based, mutations gated by env var.