MCP Google Ads

🚀 How to Build a Google Ads MCP (Managed Customer Platform) for Claude and Cursor

This project is an implementation of a Managed Customer Platform (MCP) for interacting with the Google Ads API. It allows you to configure and control through Claude Desktop and Cursor.

🚀 Quick Start

Step 1: Clone the Repository

git clone https://github.com/your-username/google-ads-mcp.git
cd google-ads-mcp

Step 2: Install Dependencies

pip install -r requirements.txt

Step 3: Configure Environment Variables

Create and edit the .env file:

GOOGLE_ADS_CREDENTIALS_PATH=/path/to/your/google-ads.json
CLAUDE_API_KEY=your_api_key_here

Step 4: Start the Service

python -m google_ads_mcp.mcp --config config.json

✨ Features

Core Functions

• Campaign Management: Create, read, update, and delete advertising campaigns.
• Ad Group Management: Operate ad groups, including adding, updating, and deleting.
• Keyword Management: Manage and optimize keywords.
• Report Generation: Automatically generate Google Ads performance reports.
• Batch Operations: Support batch processing of large-scale data.

Integrating with Claude Desktop

1. Add a Claude API call in google_ads_mcp/mcp.py:

from claude_api import ClaudeAPI

class GoogleAdsMCP:
    def __init__(self):
        self.claude = ClaudeAPI(your_api_key)

    # Other methods...

2. Register your service in Caulde Desktop: Create a new Python file claude_plugin.py:

from google_ads_mcp.mcp import GoogleAdsMCP

class GoogleAdsPlugin:
    def __init__(self, api_key):
        self.mcp = GoogleAdsMCP()

    def get_advertising_campaigns(self):
        return self.mcp.list_campaigns()

Using Cursor

1. Create google_ads_mcp/cursor_extension.py:

from .mcp import GoogleAdsMCP

class GoogleAdsExtension:
    def __init__(self):
        self.mcp = GoogleAdsMCP()

    def get_campaigns(self):
        return self.mcp.list_campaigns()

2. Create setup.py in the project root directory:

from setuptools import setup, find_packages

setup(
    name="google-ads-mcp",
    version="1.0.0",
    packages=find_packages(),
    install_requires=[
        "google-ads",
        "claude_api"
    ]
)

📦 Project Structure

google-ads-mcp/
├── google_ads_mcp/
│   ├── __init__.py
│   ├── mcp.py                 # Core MCP implementation
│   ├── services/             # Definition of all services
│   │   └── ads_service.py    # Google Ads API service
│   └── tests/               # Test files
│       ├── test_google_ads_mcp.py  # Main test file
│       └── test_token_refresh.py   # Authentication and token refresh test
├── .env                       # Environment variable file
├── config.json                # MCP configuration file
├── requirements.txt           # Project dependencies
└── README.md                  # Project documentation

💻 Usage Examples

Basic Usage

The basic usage has been demonstrated in the "Quick Start" section. Here is a summary of the key steps:

# Clone the repository
git clone https://github.com/your-username/google-ads-mcp.git
cd google-ads-mcp

# Install dependencies
pip install -r requirements.txt

# Configure environment variables
echo "GOOGLE_ADS_CREDENTIALS_PATH=/path/to/your/google-ads.json" >> .env
echo "CLAUDE_API_KEY=your_api_key_here" >> .env

# Start the service
python -m google_ads_mcp.mcp --config config.json

Advanced Usage

The advanced usage includes integrating with Claude Desktop and Cursor, as described in the "Features" section.

🧪 Testing

Environment Variable Configuration

Edit tests/test_google_ads_mcp.py:

import os
from unittest.mock import patch
from google_ads_mcp.mcp import GoogleAdsMCP

def test_init():
    with patch.dict('os.environ', {
        'GOOGLE_ADS_CREDENTIALS_PATH': '/path/to/google-ads.json',
        'CLAUDE_API_KEY': 'test_key'
    }):
        mcp = GoogleAdsMCP()
        assert mcp.credentials_path == '/path/to/google-ads.json'
        assert mcp.claude_api_key == 'test_key'

Running Tests

Run the following command:

python -m pytest tests/

🛠️ Troubleshooting

Incorrect Environment Variable Configuration

1. Check if the .env file path is correct.
2. Ensure that all environment variables are set.

Authentication Failure

1. Verify that the Google Ads API credentials file exists and its content is correct.
2. Ensure that the Claude API key is valid.

📄 License

This project uses the MIT license. Please refer to the LICENSE file for detailed information.

📞 Contact

If you have any feedback, please contact:

ernesto@ixigo.com

📚 Appendix

Example Configuration File config.json

{
    "google_ads": {
        "client_id": "your_client_id",
        "client_secret": "your_client_secret"
    },
    "claude": {
        "api_key": "your_api_key_here"
    }
}

Additional Resources

• Google Ads API Documentation
• Claude API Documentation