Google Ads Model Context Protocol (MCP) Setup & Tool Reference

Exposes campaign creation, GAQL search parameters, keyword targeting metrics, and optimization recommendations directly to LLM clients.

Connector Capabilities

Secure Python Model Context Protocol (MCP) server that connects your Google Ads account to Claude, Cursor, or Antigravity IDE.

Raw GAQL queries: Let the AI write and run query language commands directly to inspect conversions, CTR, and search queries.
Manage campaigns: Pause, enable, create, or update campaigns, ad groups, budgets, and keywords.
MCC Manager Support: Automatically resolves nested MCC sub-accounts from a single credentials config.

Installation Steps

Step 1Clone the connector:

Terminal

git clone https://github.com/pralayasimha23/google-ads-mcp-connector.git
cd google-ads-mcp-connector

Step 2Setup Python env:

Terminal

python3 -m venv venv
source venv/bin/activate # (venv\Scripts\activate on Windows)
pip install -r requirements.txt

Step 3Configure credentials:

Add a .env file in the folder root:

.env

GOOGLE_ADS_DEVELOPER_TOKEN=your_token
GOOGLE_ADS_CLIENT_ID=your_id
GOOGLE_ADS_CLIENT_SECRET=your_secret
GOOGLE_ADS_REFRESH_TOKEN=your_refresh_token
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_manager_mcc_id

Claude Desktop Configuration

Add this configuration to your local claude_desktop_config.json:

JSON

{
  "mcpServers": {
    "google-ads": {
      "command": "/path/to/google-ads-mcp-connector/venv/bin/python",
      "args": [
        "/path/to/google-ads-mcp-connector/server.py"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_CUSTOMER_ID"
      }
    }
  }
}

Cursor Registration

Go to Settings > Features > MCP in Cursor. Click + Add New MCP Server. Set type to command and enter:

Command

python /path/to/google-ads-mcp-connector/server.py

Google Ads MCP Documentation

Connector Capabilities

Installation Steps

Claude Desktop Configuration

Cursor Registration

Registered Tools Explorer