npm · google-ads-mcp-unofficial
$npx -y google-ads-mcp-unofficial@0.1.3 GOOGLE_ADS_DEVELOPER_TOKEN · secret — Google Ads API developer token from your Google Ads Manager account. Required.
GOOGLE_ADS_CLIENT_ID — Google OAuth2 client ID. Required.
GOOGLE_ADS_CLIENT_SECRET · secret — Google OAuth2 client secret. Prefer storing in ~/.google-ads-mcp/config.json via setup.
GOOGLE_ADS_LOGIN_CUSTOMER_ID — Manager (MCC) customer ID used as login-customer-id header, no dashes (e.g., 1234567890). Optional but required for multi-account access.
GOOGLE_ADS_REDIRECT_URI — OAuth redirect URI. Defaults to http://127.0.0.1:3000/callback.
GOOGLE_ADS_TOKEN_PATH — Optional local path for OAuth tokens. Defaults to ~/.google-ads-mcp/tokens.json (0600).
GOOGLE_ADS_PRIVACY_MODE — Optional payload mode: summary, structured, or raw. Defaults to structured. raw returns full Google Ads API payloads.
GOOGLE_ADS_ALLOW_MUTATIONS — Set to true to enable write tools (pause/resume keywords/campaigns, set bids, set budgets). Default false (read-only). Agents changing real ad spend is high-stakes; review every change.
GOOGLE_ADS_CACHE — Optional SQLite cache toggle. Set to true or sqlite to enable.
GOOGLE_ADS_CACHE_PATH — Optional local SQLite cache path. Defaults to ~/.google-ads-mcp/cache.sqlite.
GOOGLE_ADS_CACHE_TTL_SECONDS — Optional cache TTL in seconds. Defaults to 60. Set to 0 to keep entries indefinitely (entries are still overwritten on each hit).
GOOGLE_ADS_NO_RETRY — Set to true to disable the HTTP retry middleware. Default false.