gomarble-ai/google-ads-mcp-server

**A FastMCP-powered Model Context Protocol server for Google Ads API integration with automatic OAuth 2.0 authentication**
Connect Google Ads API directly to Claude Desktop and other MCP clients with seamless OAuth 2.0 authentication, automatic token refresh, GAQL querying, and keyword research capabilities.
Your browser does not support the video tag.
Easy One-Click Setup
For a simpler setup experience, we offer ready-to-use installers:
👉 **Download installer -** https://gomarble.ai/mcp
Join our community for help and updates
👉 **Slack Community -** AI in Ads
Try Facebook ads mcp server also
👉 **Facebook Ads MCP -** Facebook Ads MCP
✨ Features
- 🔐 **Automatic OAuth 2.0** - One-time browser authentication with auto-refresh
- 🔄 **Smart Token Management** - Handles expired tokens automatically
- 📊 **GAQL Query Execution** - Run any Google Ads Query Language queries
- 🏢 **Account Management** - List and manage Google Ads accounts
- 🔍 **Keyword Research** - Generate keyword ideas with search volume data
- 🚀 **FastMCP Framework** - Built on the modern MCP standard
- 🖥️ **Claude Desktop Ready** - Direct integration with Claude Desktop
- 🛡️ **Secure Local Storage** - Tokens stored locally, never exposed
📋 Available Tools
| Tool | Description | Parameters | Example Usage |
|------|-------------|------------|---------------|
| list_accounts | List all accessible Google Ads accounts | None | "List all my Google Ads accounts" |
| run_gaql | Execute GAQL queries with custom formatting | customer_id, query, manager_id (optional) | "Show me campaign performance for account 1234567890" |
| run_keyword_planner | Generate keyword ideas with metrics | customer_id, keywords, manager_id, page_url, date range options | "Generate keyword ideas for 'digital marketing'" |
**Note:** All tools automatically handle authentication - no token parameters required!
🚀 Quick Start
Prerequisites
Before setting up the MCP server, you'll need:
- Python 3.10+ installed
- A Google Cloud Platform account
- A Google Ads account with API access
🔧 Step 1: Google Cloud Platform Setup
1.1 Create Google Cloud Project
1. **Go to Google Cloud Console**
2. **Create a new project:**
- Click "Select a project" → "New Project"
- Enter project name (e.g., "Google Ads MCP")
- Click "Create"
1.2 Enable Google Ads API
1. **In your Google Cloud Console:**
- Go to "APIs & Services" → "Library"
- Search for "Google Ads API"
- Click on it and press "Enable"
1.3 Create OAuth 2.0 Credentials
1. **Go to "APIs & Services" → "Credentials"**
2. **Click "+ CREATE CREDENTIALS" → "OAuth 2.0 Client ID"**
3. **Configure consent screen (if first time):**
- Click "Configure Consent Screen"
- Choose "External" (unless you have Google Workspace)
- Fill required fields:
- App name: "Google Ads MCP"
- User support email: Your email
- Developer contact: Your email
- Click "Save and Continue" through all steps
4. **Create OAuth Client:**
- Application type: **"Desktop application"**
- Name: "Google Ads MCP Client"
- Click "Create"
5. **Download credentials:**
- Click "Download JSON" button
- Save file as client_secret_[long-string].json in your project directory
🔧 Step 2: Google Ads API Setup
2.1 Get Developer Token
1. **Sign in to Google Ads**
2. **Go to Tools & Settings** (wrench icon in top navigation)
3. **Under "Setup", click "API Center"**
4. **Accept Terms of Service** if prompted
5. **Click "Apply for token"**
6. **Fill out application form:**
- Describe your use case (e.g., "MCP integration for campaign analysis")
- Provide technical details about your implementation
7. **Submit and wait for approval** (usually 1-3 business days)
**Note:** You'll initially get a test token with limited functionality. After testing, you can apply for production access.
2.2 Find Your Developer Token