@renzo.johnson/google-ads-mcp
v26.11.15
Published
Google Ads MCP server for Claude Code, Cursor and any MCP client. Google Ads reporting, GAQL queries and campaign management. mcprush.com-3c5f87b9c75878a56ac7e87f
Maintainers
Readme
Google Ads MCP
Google Ads MCP server for Claude Code, Cursor and any MCP client. Google Ads reporting, GAQL queries and campaign management.
npx -y @renzo.johnson/google-ads-mcpThe server speaks MCP over stdio. It needs Node.js 22 or newer. Prefer VS Code? Install the Google Ads MCP extension: it signs you in with a wizard and registers the server with 8 AI agents.
Sign in
Google Ads needs a developer token and an OAuth user. Set these environment variables:
| Variable | Required | Value |
|----------|----------|-------|
| GOOGLE_ADS_DEVELOPER_TOKEN | yes | Your Google Ads API developer token |
| GOOGLE_OAUTH_CLIENT_ID | yes | OAuth client ID (Desktop app) |
| GOOGLE_OAUTH_CLIENT_SECRET | yes | OAuth client secret |
| GOOGLE_OAUTH_REFRESH_TOKEN | yes | A refresh token granted the https://www.googleapis.com/auth/adwords scope |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | for manager accounts | Manager (MCC) account ID, digits only |
| GOOGLE_ADS_DEFAULT_CUSTOMER_ID | no | Account used when a tool call names none |
GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET and GOOGLE_ADS_REFRESH_TOKEN also work and take precedence.
Claude Code
Add it from the command line:
claude mcp add google-ads -- npx -y @renzo.johnson/google-ads-mcpOr add it to .mcp.json in your project (or ~/.claude.json for every project).
Cursor
Add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Configuration
Claude Code and Cursor use the same JSON shape:
With your Google Ads credentials:
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
"GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret",
"GOOGLE_OAUTH_REFRESH_TOKEN": "your-refresh-token",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
}
}
}
}Available Tools (14)
Read Tools (10)
| Tool | What It Does | Example Prompt |
|------|-------------|----------------|
| ping | Check server connectivity | "Ping the Google Ads MCP server" |
| ads_list_accounts | List accessible customer accounts | "Show me all my Google Ads accounts" |
| ads_account_info | Account details (name, currency, timezone) | "What timezone is my Ads account set to?" |
| ads_campaigns | List campaigns with metrics | "Show me all active campaigns and their performance" |
| ads_ad_groups | List ad groups with metrics | "Show ad groups for campaign 123456" |
| ads_ads | List ads with headlines and descriptions | "Show me the ads in my brand campaign" |
| ads_keywords | Keyword performance report | "What are my top 20 keywords by clicks?" |
| ads_search_terms | Search terms report | "What are users actually searching to find my ads?" |
| ads_performance | Account/campaign performance summary | "Show me account performance for March 2026" |
| ads_query | Run arbitrary GAQL queries (read-only) | "Run a GAQL query for campaign metrics by device" |
Admin Mega-Tools (4)
All admin actions require confirm: true because they affect real ad spend.
Campaign Admin
| Action | Description |
|--------|-------------|
| create_campaign | Create a new search campaign (starts paused) |
| update_campaign | Update campaign name |
| pause_campaign | Pause a campaign |
| enable_campaign | Enable a paused campaign |
| remove_campaign | Remove a campaign |
| update_budget | Change daily budget |
Ad Group Admin
| Action | Description |
|--------|-------------|
| create_ad_group | Create a new ad group (starts paused) |
| update_ad_group | Update name or CPC bid |
| pause_ad_group | Pause an ad group |
| enable_ad_group | Enable a paused ad group |
| remove_ad_group | Remove an ad group |
Ad Admin
| Action | Description |
|--------|-------------|
| create_responsive_search_ad | Create a responsive search ad (starts paused) |
| pause_ad | Pause an ad |
| enable_ad | Enable a paused ad |
| remove_ad | Remove an ad |
Keyword Admin
| Action | Description |
|--------|-------------|
| add_keywords | Add keywords to an ad group |
| pause_keyword | Pause a keyword |
| enable_keyword | Enable a paused keyword |
| remove_keyword | Remove a keyword |
| update_bid | Change keyword CPC bid |
Safety
Every write action requires explicit confirmation. Unlike other Google MCP extensions where only destructive actions need confirmation, Google Ads MCP requires confirm: true for ALL admin actions -- because every action affects real advertising spend.
New campaigns, ad groups, and ads are always created in a paused state to prevent accidental spend.
Privacy
The server sends no telemetry. It talks only to Google APIs, with your own credentials.
Links
By Renzo Johnson | MIT License
