Google Ads MCP Server: Automate Optimization & Boost ROI

Google Ads MCP Server

Updated on March 21, 2024 - Triggering workflow run

A Model Context Protocol (MCP) server that provides access to Google Ads data through Claude Desktop.

Features

• Access Google Ads campaigns, accounts, and performance metrics via Claude
• Support for both Manager (MCC) and client account data
• Built-in caching to improve performance and reduce API calls
• Claude Artifacts integration for data visualization
• Multi-environment support (development, testing, production)
• Containerized deployment with Docker

Prerequisites

• Python 3.9 or higher
• Google Ads API credentials
• Claude Desktop

Quick Start

Local Development

1. Clone this repository:

   git clone https://github.com/yourusername/google-ads-mcp.git

cd google-ads-mcp

2. Set up a virtual environment:

   python -m venv .venv

source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create a .env file with your Google Ads credentials:

   cp .env.example .env

# Edit .env file with your credentials

5. Run the server:

   python server.py

Docker Deployment

1. Build the Docker image:

   docker build -t google-ads-mcp:latest .

2. Run the container:

   docker run -p 8000:8000 --env-file .env google-ads-mcp:latest

Alternatively, use docker-compose:

docker-compose up -d

Configuration

The application supports different environments (dev, test, prod) with environment-specific configurations:

• Set APP_ENV to dev, test, or prod to specify the environment
• Configure environment variables as documented in .env.example
• Feature flags allow enabling/disabling specific functionality

Claude Desktop Integration

1. Configure Claude Desktop for the MCP server in your Claude Desktop App configuration:

   {
   "mcpServers": {
   "google-ads": {
   "command": "python",
   "args": [
   "/absolute/path/to/server.py"
   ]
   }
   }

}

2. Restart Claude Desktop and look for the tools icon to appear

3. Use Google Ads data in Claude by asking questions like:

* "Show me my Google Ads account performance"
* "What campaigns are performing well in my account?"
* "Create a visualization of my campaign performance"

Deployment

This repository includes Kubernetes manifests for deployment:

• kubernetes/dev/ - Development environment deployment
• kubernetes/test/ - Test environment deployment
• kubernetes/prod/ - Production environment deployment

CI/CD pipelines are configured using GitHub Actions for automated testing, building, and deployment.

Security

• All credentials are stored in Kubernetes secrets or environment variables, never in code
• The server uses proper authentication for API access
• Rate limiting is enabled in production environments
• Container security best practices are followed

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -am 'Add new feature'
4. Push to the branch: git push origin feature/my-feature
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• Google Ads API team for their documentation and support
• Anthropic for Claude and the Model Context Protocol