Google Ads
Read Google Ads performance and prepare confirmed changes from an MCP client
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 2.1.2
- Listing updated
- 2 days ago
About Google Ads
Google Ads is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Reading is the default; writing is opt-in. The npm package ships 35 read tools covering campaign performance, search terms, Performance Max assets, Shopping products, change history and Keyword Planner research, plus raw GAQL queries. Another 13 write tools stay hidden until GOOGLE_ADS_ENABLE_WRITES is set to true, and even then each call only previews a change until confirm:true is passed.
This open-source package runs locally over stdio with your own credentials: a Google Ads developer token (Basic Access or above), an OAuth client ID, secret and refresh token, and optionally a manager account ID. GOOGLE_ADS_ACCOUNT_IDS can restrict every tool to a list of customers, and the README says it becomes required in 3.0.0. It pins Google Ads API v26 and needs a recent Node.js 22, 24 or 26 release.
The maker, Get MCP Ads, also offers a hosted version with Google sign-in, account picking and extras such as dashboards, alerts and Sheets exports. Those belong to the hosted product, not this package.
Install
Run in a terminal
claude mcp add google-ads --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>' -- npx -y @getmcpads/google-ads-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"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>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"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>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"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>"
}
}
}
}Configuration
GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads API developer token, Basic Access or above.RequiredGOOGLE_ADS_CLIENT_IDOAuth client ID.RequiredGOOGLE_ADS_CLIENT_SECRETOAuth client secret.RequiredGOOGLE_ADS_REFRESH_TOKENOAuth refresh token.RequiredGOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) account ID, when the customer sits under one.GOOGLE_ADS_ACCOUNT_IDSComma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.GOOGLE_ADS_ENABLE_WRITESSet to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- google_ads_run_gaql
- Runs raw GAQL queries against Google Ads API v26.
- google_ads_run_readonly_rpc
- Sends read-only RPC requests, also following API v26.
What it does
- 35 read tools
- Reports on campaigns, search terms, Performance Max, Shopping and change history.
- Opt-in writes
- 13 write tools appear only when GOOGLE_ADS_ENABLE_WRITES is true.
- Preview before apply
- Write calls preview by default and apply only with confirm:true.
- Raw GAQL
- Run Google Ads Query Language queries directly against API v26.
- Account allow-list
- GOOGLE_ADS_ACCOUNT_IDS limits every tool to the customers you list.
- Keyword Planner
- Keyword ideas, historical metrics and forecasts from the conversation.
Good for
- Ask which search terms drove spend last month
- Review Performance Max asset results
- Pause a campaign or change a daily budget after a preview
- Research keyword ideas and forecasts
- Limit an assistant to a few client accounts under a manager account
Pricing
Open source, from $39 a month
Open-source package; optional hosted plans from $39/mo (Pro), with a free 1-account tier
Prices change. Check getmcpads.com before you buy.
Google Ads FAQ
Can it change my campaigns?
Only if you set GOOGLE_ADS_ENABLE_WRITES to true. Even then, calls preview by default and apply changes only with confirm:true.
What credentials does it need?
A Google Ads developer token, OAuth client ID, client secret and refresh token; a manager account ID is optional.
Is there a hosted option?
Yes. Get MCP Ads offers a hosted connection with Google sign-in. Its Free plan covers 1 ad account with 200 requests a month; Pro is $39/month.
Which Node.js versions work?
Node.js 22.23.4, 24.22.1 or 26.12.1, or a newer release of those lines.
Is Google Ads free?
Yes. Google Ads is open source, so you can use and self-host it for free.
How do I add Google Ads to Claude Code?
Run this command in your terminal: claude mcp add google-ads --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>' -- npx -y @getmcpads/google-ads-mcp-server
What are the best alternatives to Google Ads?
The closest alternatives to Google Ads are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.
Alternatives to Google Ads

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

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

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data