Google Ads MCP
Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.1
- Listing updated
- 4 days ago
About Google Ads MCP
Google Ads MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.
Install
Run in a terminal
claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_LOGIN_CUSTOMER_ID='<GOOGLE_ADS_LOGIN_CUSTOMER_ID>' -- uvx scalably-google-ads-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"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>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"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>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-ads-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"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>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"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>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-ads-mcp": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"env": {
"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>",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
}
}
}
}Configuration
GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads API developer token from the Ads API CenterRequiredGOOGLE_ADS_CLIENT_IDOAuth2 client_id for a Desktop-app credentialRequiredGOOGLE_ADS_CLIENT_SECRETOAuth2 client_secret paired with the client_idRequiredGOOGLE_ADS_REFRESH_TOKENLong-lived OAuth2 refresh_token for the adwords scopeRequiredGOOGLE_ADS_LOGIN_CUSTOMER_ID10-digit customer ID of the manager account (MCC)RequiredGOOGLE_ADS_API_VERSIONGoogle Ads API version to target, default set by the serverGOOGLE_ADS_LOG_LEVELLog level, default WARNINGGOOGLE_ADS_USE_PROTO_PLUSUse proto-plus message types, default true
Pricing
Open source
Prices change. Check scalably.io before you buy.
Google Ads MCP FAQ
Is Google Ads MCP free?
Yes. Google Ads MCP is open source, so you can use and self-host it for free.
How do I add Google Ads MCP to Claude Code?
Run this command in your terminal: claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_LOGIN_CUSTOMER_ID='<GOOGLE_ADS_LOGIN_CUSTOMER_ID>' -- uvx scalably-google-ads-mcp
What are the best alternatives to Google Ads MCP?
The closest alternatives to Google Ads MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and PostBaton.
Alternatives to Google Ads MCP

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

ASOScan
MCP serverASO data for your own iOS and Android apps: rankings, keywords, reviews, scores
- Remote
- Free trial
- Marketing and SEO