google-ads-mcp

Unofficial Google Ads MCP for campaigns, keywords, budgets, and gated mutations.

stdiocommunityservice

Package Details

google-ads-mcp-unofficial

0.1.3•https://www.npmjs.com/package/google-ads-mcp-unofficial

Transportstdio

Environment Variables

GOOGLE_ADS_DEVELOPER_TOKEN(str)

Secret

Google Ads API developer token from your Google Ads Manager account. Required.

GOOGLE_ADS_CLIENT_ID(str)

Google OAuth2 client ID. Required.

GOOGLE_ADS_CLIENT_SECRET(str)

Secret

Google OAuth2 client secret. Prefer storing in ~/.google-ads-mcp/config.json via setup.

GOOGLE_ADS_LOGIN_CUSTOMER_ID(str)

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(str)

OAuth redirect URI. Defaults to http://127.0.0.1:3000/callback.

GOOGLE_ADS_TOKEN_PATH(str)

Optional local path for OAuth tokens. Defaults to ~/.google-ads-mcp/tokens.json (0600).

GOOGLE_ADS_PRIVACY_MODE(str)

Optional payload mode: summary, structured, or raw. Defaults to structured. raw returns full Google Ads API payloads.

GOOGLE_ADS_ALLOW_MUTATIONS(str)

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(str)

Optional SQLite cache toggle. Set to true or sqlite to enable.

GOOGLE_ADS_CACHE_PATH(str)

Optional local SQLite cache path. Defaults to ~/.google-ads-mcp/cache.sqlite.

GOOGLE_ADS_CACHE_TTL_SECONDS(str)

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(str)

Set to true to disable the HTTP retry middleware. Default false.