Google Ads MCP Setup Skill

Guide for connecting MiniAgent's MCP servers to real ad platform APIs.

Claude Code Setup

claude mcp add miniagent-google -- python -m miniagent.mcp.google_ads

Or add to .mcp.json:

{
  "mcpServers": {
    "miniagent-google": {
      "command": "python",
      "args": ["-m", "miniagent.mcp.google_ads"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_ADS_CLIENT_SECRET": "your-secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Getting Credentials

1. Developer Token: Google Ads → Tools → API Center → Apply
2. OAuth Client: Google Cloud Console → APIs → Credentials → Create OAuth Client ID
3. Refresh Token: Run python -m miniagent.mcp.google_ads --oauth to start the OAuth flow
4. Customer ID: The 10-digit number in the top-right of Google Ads (no dashes)

Troubleshooting

Error	Cause	Fix
AUTHENTICATION_ERROR	Bad credentials	Check all 4 env vars are set
AUTHORIZATION_ERROR	No access to account	Verify customer_id, check MCC access
DEVELOPER_TOKEN_NOT_APPROVED	Token pending	Apply at Google Ads API Center
RATE_LIMIT_EXCEEDED	Too many requests	Add retry logic, check quota