jarrah-gads-mcp

A minimal MCP server that exposes Google Ads query capabilities as tools for use with Claude and other MCP clients.

Tools

Setup

1. Install

pip install jarrah-gads-mcp

2. Configure credentials

Create a .env file in your working directory:

GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token
GOOGLE_ADS_CLIENT_ID=your_client_id
GOOGLE_ADS_CLIENT_SECRET=your_client_secret
GOOGLE_ADS_REFRESH_TOKEN=your_refresh_token
GOOGLE_ADS_CUSTOMER_ID=123-456-7890
# GOOGLE_ADS_LOGIN_CUSTOMER_ID=  # only needed for MCC manager accounts

3. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": ["jarrah-gads-mcp"]
    }
  }
}

Restart Claude Desktop. The tools will appear in the tools panel.

GAQL notes

• run_gaql uses search() (not search_stream) — suitable for ad-hoc queries up to 100 rows.
• Always include a date filter; the Google Ads API rejects most queries without one.
• Customer ID dashes are stripped automatically before the API call.

Source

github.com/jarrah-agency/google-ads-mcp