Google Ads MCP Server

# Copy to .env and fill in values. Do NOT commit .env. # Notes # - Most tools use Application Default Credentials (ADC). Preferred path is gcloud: # gcloud auth application-default login --scopes=https://www.googleapis.com/auth/adwords # - Never commit real tokens or ADC files. # Required: Google Ads developer token # Your Google Ads Developer Token (string). Obtain from Google Ads UI. # Docs: https://developers.google.com/google-ads/api/docs/get-started/dev-token GOOGLE_ADS_DEVELOPER_TOKEN= # ADC file path (optional) # Absolute path to an ADC authorized_user JSON. If set, overrides well-known ADC. # Example: /Users/me/.config/gcloud/application_default_credentials.json GOOGLE_APPLICATION_CREDENTIALS= # Quota project for ADC billing (optional) # GCP project ID used for quota/billing. Helps avoid 403s due to missing quota. # Typically your active gcloud project ID (e.g., my-gcp-project). GOOGLE_ADS_QUOTA_PROJECT_ID= # Manager account ID (MCC) (optional) # 10-digit numeric ID for your manager account (no dashes/spaces). # Set when acting through an MCC context (login-customer). # Example: 1234567890 GOOGLE_ADS_MANAGER_ACCOUNT_ID= # Account (customer) ID (optional) # 10-digit numeric ID for the customer on which queries run by default (no dashes/spaces). # Example: 1234567890 GOOGLE_ADS_ACCOUNT_ID= # Google Ads API version (optional) # Version string (e.g., v20, v21, v22). Defaults to v21 if unset. # Supports: "21", "v21", "V21" (normalized to "v21") GOOGLE_ADS_API_VERSION= # OAuth client for device flow (optional) # Desktop OAuth client used by manage_auth { action: "oauth_login" } to create local ADC. # Use only if you cannot use gcloud. Do not commit real values. GOOGLE_OAUTH_CLIENT_ID= GOOGLE_OAUTH_CLIENT_SECRET= # Direct access token (dev/testing only; optional) # Used by unit tests; for mocked tests this can be any non-empty string. # When set, bypasses ADC. For real API calls prefer ADC; if used, this must be a real # OAuth 2.0 access token with the Google Ads scope and will not auto-refresh. GOOGLE_ADS_ACCESS_TOKEN=