Mcp Google Ads
About
# mcp-google-ads Multi-account Google Ads MCP server. Connect any number of Google Ads accounts to Claude, Cursor, Codex, or any MCP-compatible AI assistant — query campaign performance, keywords, search terms, and account analytics by name in the same session. ``` # Install: uvx mcp-google-ads-multi # Ask your AI…
Explore
- Supports multiple named Google Ads accounts, switchable per tool call.
- Mixed authentication: OAuth and service account per account.
- Provides quality score data for keywords.
- Includes search terms report (actual user queries).
- Automatic rate‑limit retry with exponential backoff.
- Supports SSE transport for remote deployment.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Google AdsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Get a developer token — apply at Google Ads API Center (free, ~3 business days)
2. Create OAuth credentials — Google Cloud Console → Enable Google Ads API → Credentials → OAuth client ID → Desktop app
3. Create your accounts config:
mkdir -p ~/.config/mcp-google-ads
cp accounts.example.json ~/.config/mcp-google-ads/accounts.json
{
"default": "my-account",
"accounts": {
"my-account": {
"type": "oauth",
"client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"client_secret": "YOUR_CLIENT_SECRET",
"token_file": "~/.config/mcp-google-ads/my-account.token"
},
"client-acme": {
"type": "oauth",
"client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"client_secret": "YOUR_CLIENT_SECRET",
"token_file": "~/.config/mcp-google-ads/client-acme.token"
}
}
}
``
Set
GOOGLE_ADS_DEVELOPER_TOKEN in your environment. All other credentials stay local.
---
| Variable | Default | Description |
|---|---|---|
|
GOOGLE_ADS_DEVELOPER_TOKEN | required | Your Google Ads API developer token |
| GOOGLE_ADS_ACCOUNTS_CONFIG | ~/.config/mcp-google-ads/accounts.json | Path to accounts config |
| MCP_TRANSPORT | stdio | Set to sse for remote deployment |
| MCP_HOST | 127.0.0.1 | SSE bind host |
| MCP_PORT | 3001` | SSE bind port |
---
list_accounts
Show all configured accounts
set_default_account
Change the default account
list_customers
List all accessible Google Ads accounts under your login
get_account_summary
Total clicks, cost, conversions for a period
list_campaigns
All campaigns with status, budget, 30-day metrics
get_campaign_performance
Campaign metrics for any date range
compare_periods
Two date ranges side-by-side with deltas
get_keyword_performance
Keyword metrics + quality scores
search_terms_report
Actual search queries that triggered your ads
get_ad_performance
Ad-level CTR and conversions
| Tool | What it does |
|---|---|
| list_accounts | Show all configured accounts |
| set_default_account | Change the default account |
| list_customers | List all accessible Google Ads accounts under your login |
| get_account_summary | Total clicks, cost, conversions for a period |
| list_campaigns | All campaigns with status, budget, 30-day metrics |
| get_campaign_performance | Campaign metrics for any date range |
| compare_periods | Two date ranges side-by-side with deltas |
| get_keyword_performance | Keyword metrics + quality scores |
| search_terms_report | Actual search queries that triggered your ads |
| get_ad_performance | Ad-level CTR and conversions |
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp google ads": {
"google-ads": {
"command": "uvx",
"args": [
"mcp-google-ads-multi"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
"GOOGLE_ADS_ACCOUNTS_CONFIG": "~/.config/mcp-google-ads/accounts.json"
}
}
}
}
}McpServers
{
"google-ads": {
"command": "uvx",
"args": [
"mcp-google-ads-multi"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
"GOOGLE_ADS_ACCOUNTS_CONFIG": "~/.config/mcp-google-ads/accounts.json"
}
}
}Multi-account Google Ads MCP server. Connect any number of Google Ads accounts to Claude, Cursor, Codex, or any MCP-compatible AI assistant — query campaign performance, keywords, search terms, and account analytics by name in the same session.
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
