Google Ads MCP
Google Ads reports, GAQL queries and confirmed campaign changes from your agent
- Pricing
- Open source
- Platforms
- vscode, CLI
- Runs
- Locally
- Version
- 26.11.13
- Listing updated
- 2 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.
Fourteen tools split ten reads from four admin tools. Reads cover accounts, campaigns, ad groups, ads, keywords, search terms and performance totals, and ads_query runs any read-only Google Ads Query Language SELECT for cuts such as clicks by device or conversions by location. Admin tools create and manage search campaigns, ad groups, responsive search ads and keywords.
Because every admin action can spend money, each one needs confirm: true, and new campaigns, ad groups and ads are created paused. It does not create Performance Max, Shopping, Display or video campaigns, and creating a campaign requires an EU political advertising declaration. Amounts are in micros, which the agent converts.
It is an independent local extension and npm package, not Google's official server. You need your own developer token with approved access, OAuth credentials and a customer ID; a manager account works.
Install
Run in a terminal
claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-ads-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Configuration
GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads API developer token.RequiredGOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.RequiredGOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.RequiredGOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Ads scope.RequiredGOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) account ID, digits only, when you access accounts through a manager.GOOGLE_ADS_DEFAULT_CUSTOMER_IDAccount used when a tool call names none.
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- ads_list_accounts
- List reachable customer accounts.
- ads_account_info
- Account name, currency, time zone and manager status.
- ads_campaigns
- Campaigns with status, budget and metrics.
- ads_ad_groups
- Ad groups with metrics.
- ads_ads
- Ads with headlines, descriptions and metrics.
- ads_keywords
- Keyword performance.
- ads_search_terms
- Search terms report.
- ads_performance
- Account or per-campaign totals for a date range.
- ads_query
- Run a read-only GAQL query.
- ping
- Check the server is running.
- ads_campaign_admin
- Create and manage search campaigns.
- ads_ad_group_admin
- Create and manage ad groups.
- ads_ad_admin
- Create and manage responsive search ads.
- ads_keyword_admin
- Add and manage keywords.
What it does
- Read tools
- Accounts, campaigns, ad groups, ads, keywords and search terms.
- GAQL queries
- Run any read-only query for custom breakdowns.
- Performance totals
- Account totals, or by campaign, for a date range.
- Campaign admin
- Create search campaigns, pause, enable, remove and change budgets.
- Ad and keyword admin
- Create responsive search ads and keywords with match types.
- Confirmation and paused starts
- Changes need confirm: true and new items start paused.
Good for
- List search terms with spend and no conversions
- Compare this week with last week by campaign
- Pause the campaign with the highest cost per conversion
- Draft a paused campaign for review
- Switch between client accounts under a manager account
Pricing
Open source
Free, MIT licensed
Prices change. Check renzojohnson.com before you buy.
Google Ads MCP FAQ
Is it Google's official server?
No, it is an independent extension using your own developer token.
Can it spend without asking?
Every admin action needs confirmation and new items are created paused.
Does it cost anything?
The extension is free and MIT licensed; you pay Google for ads as usual.
What do I need first?
A Google Ads account, an approved developer token, OAuth credentials and your customer ID.
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_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcp
What are the best alternatives to Google Ads MCP?
The closest alternatives to Google Ads MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.
Alternatives to Google Ads MCP

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