Google Ads MCP server
{
"mcpServers": {
"getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server@latest"
],
"env": {
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google_ads_developer_token>",
"GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google_ads_client_secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google_ads_refresh_token>"
}
}
}
}{
"mcpServers": {
"getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server@latest"
],
"env": {
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google_ads_developer_token>",
"GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google_ads_client_secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google_ads_refresh_token>"
}
}
}
}{
"mcpServers": {
"getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server@latest"
],
"env": {
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google_ads_developer_token>",
"GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google_ads_client_secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google_ads_refresh_token>"
}
}
}
}{
"servers": {
"getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server@latest"
],
"env": {
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "${input:google_ads_login_customer_id}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "${input:google_ads_developer_token}",
"GOOGLE_ADS_CLIENT_ID": "${input:google_ads_client_id}",
"GOOGLE_ADS_CLIENT_SECRET": "${input:google_ads_client_secret}",
"GOOGLE_ADS_REFRESH_TOKEN": "${input:google_ads_refresh_token}"
}
}
},
"inputs": [
{
"id": "google_ads_login_customer_id",
"type": "promptString",
"description": "Google ads login customer id",
"password": true
},
{
"id": "google_ads_developer_token",
"type": "promptString",
"description": "Google ads developer token",
"password": true
},
{
"id": "google_ads_client_id",
"type": "promptString",
"description": "Google ads client id",
"password": true
},
{
"id": "google_ads_client_secret",
"type": "promptString",
"description": "Google ads client secret",
"password": true
},
{
"id": "google_ads_refresh_token",
"type": "promptString",
"description": "Google ads refresh token",
"password": true
}
]
}{
"mcpServers": {
"getmcpads-google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server@latest"
],
"env": {
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<google_ads_login_customer_id>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<google_ads_developer_token>",
"GOOGLE_ADS_CLIENT_ID": "<google_ads_client_id>",
"GOOGLE_ADS_CLIENT_SECRET": "<google_ads_client_secret>",
"GOOGLE_ADS_REFRESH_TOKEN": "<google_ads_refresh_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @getmcpads/google-ads-mcp-serverversion 1.0.2
What it does
An MCP server for the Google Ads API that exposes 31 read tools and 7 write tools for managing and analyzing Google Ads campaigns. It includes full Keyword Planner access, metric/dimension catalogues, and a compatibility matrix. For developers and marketing professionals who want to read and modify Google Ads data through Claude, ChatGPT, Cursor, or other MCP clients without needing to know GAQL.
- Retrieve campaign performance data, budgets, ad groups, and search terms to analyze and report on account activity.
- Plan keywords using the Keyword Planner tools to get keyword ideas, historical metrics, forecasts, and ad group themes.
- Make changes to campaigns such as updating status, budgets, bids, schedules, or renaming after previewing the changes first.
Tools this server exposes
| Tool | Does |
|---|---|
| google_ads_validate_query | Check a combination of metrics and dimensions for validity before running a query. |
| google_ads_run_gaql | Execute raw GAQL queries against Google Ads data. |
| google_ads_run_readonly_rpc | Call Google Ads API services that GAQL cannot reach, such as Keyword Planner and Reach Planner. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.