Model Context Protocol (MCP) AI Marketing Connectors

Capabilities

A secure Python-based MCP server that connects Google Ads accounts to agentic clients. It provides complete read/write capability via standard developer API credentials.

Raw GAQL Support: Let the AI write and execute custom Google Ads Query Language queries returning clean Markdown tables, CSV, or JSON.
Universal Campaign Manager: Supports creating and managing budgets, campaigns, ad groups, and keywords for Search, PMax, Demand Gen, Local, and Display networks.
Deep Attribution: Query impressions, CTR, conversions, average CPC, and conversion values segmented by device types or geographic locations.
AI Recommendation Engine: Retrieve active optimization recommendations and optimization score impact directly from Google's analytics suite.

Installation & Setup

Step 1Clone Server Repository:

Powershell / Bash

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

Step 2Configure Virtual Environment:

Windows

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

macOS / Linux

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Step 3Set Environment Credentials:

Create a .env file in your local root or pass these directly to your client environment:

.env Configuration

GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token_here
GOOGLE_ADS_CLIENT_ID=your_oauth_client_id_here
GOOGLE_ADS_CLIENT_SECRET=your_oauth_client_secret_here
GOOGLE_ADS_REFRESH_TOKEN=your_oauth_refresh_token_here
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_manager_mcc_id_if_applicable

Claude Desktop Configuration

Add this block inside the mcpServers section in your claude_desktop_config.json file:

JSON Config

{
  "mcpServers": {
    "google-ads": {
      "command": "/absolute/path/to/google-ads-mcp-connector/venv/bin/python",
      "args": [
        "/absolute/path/to/google-ads-mcp-connector/server.py"
      ],
      "env": {
        "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_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_CUSTOMER_ID_IF_MCC"
      }
    }
  }
}

Note for Windows: Escape backslashes as double-backslashes (e.g. C:\\path\\to\\python.exe).

Cursor IDE Registration

To configure within Cursor IDE:

1 Open Cursor and navigate to Settings > Features > MCP.

2 Click + Add New MCP Server.

3 Set Type to command, Name to google-ads.

4 Enter the command line below, replacing paths with your local folder:

Cursor Command

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

Antigravity IDE / CLI

If you are utilizing Google Deepmind's Antigravity system, automatically register the connector by running the setup script in the server directory:

Antigravity Registration

python configure_local_mcp.py

Capabilities

A Python-based MCP server wrapping the Meta Graph API. Exposes ad accounts, campaign parameters, adset budgets, creatives, and performance insights directly to your developer agent.

Creative Breakdown Reports: Fetch performance breakdown for specific image, copy, and video creatives.
Interactive Mutates: Build and launch complete campaigns (leads, conversions, traffic, awareness), budgets, adsets, and creatives.
Deep Placements Analytics: Compare conversion rates, impressions, and ROI between Facebook Feed, Instagram Stories, Reels, and Audience Network.
A/B Test Suite: Request automated statistical comparison between active A/B testing campaigns.

Installation & Setup

Step 1Clone Server Repository:

Terminal

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

Step 2Install Dependencies:

Terminal Command

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

Step 3Set Environment Variables:

.env Configuration

META_ADS_ACCESS_TOKEN=your_system_user_access_token_here
META_ADS_AD_ACCOUNT_ID=act_your_default_ad_account_id_here
META_APP_ID=your_meta_developer_app_id
META_APP_SECRET=your_meta_developer_app_secret

Claude Desktop Configuration

Add this block inside the mcpServers section in your claude_desktop_config.json file:

JSON Config

{
  "mcpServers": {
    "meta-ads": {
      "command": "/absolute/path/to/meta-ads-mcp-connector/venv/bin/python",
      "args": [
        "/absolute/path/to/meta-ads-mcp-connector/server.py"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "YOUR_SYSTEM_USER_ACCESS_TOKEN",
        "META_ADS_AD_ACCOUNT_ID": "act_YOUR_DEFAULT_AD_ACCOUNT_ID",
        "META_APP_ID": "YOUR_APP_ID",
        "META_APP_SECRET": "YOUR_APP_SECRET"
      }
    }
  }
}

Cursor IDE Registration

To configure within Cursor IDE:

1 Navigate to Settings > Features > MCP in Cursor.

2 Select + Add New MCP Server.

3 Set Type to command, Name to meta-ads.

4 Enter the command line below, replacing paths:

Cursor Command

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

Antigravity Integration

Easily register the Meta Ads MCP Server locally in your Antigravity user config schema directory:

CLI Command

python configure_local_mcp.py --server meta-ads

Registered Tools Explorer

Browse the complete API schemas and methods exposed to the AI model.

🔍

No matching tools found in this MCP connector.

AI Marketing MCP Connectors

Capabilities

Installation & Setup

Claude Desktop Configuration

Cursor IDE Registration

Antigravity IDE / CLI

Capabilities

Installation & Setup

Claude Desktop Configuration

Cursor IDE Registration

Antigravity Integration

Registered Tools Explorer