Claude MarketplacesSubmit
zleventer avatar

Google Ads

zleventer/google-ads-mcp

Built for paid search teams who need to diagnose Google Ads performance beyond dashboard metrics. Wraps the Google Ads API with 22 tools covering RSA asset labels, auction insights, impression share breakdowns, search term reports, geo and device splits, audience targeting, and budget pacing. Ships with a raw GAQL query tool when you need custom reports. Requires a Google Ads developer token and OAuth credentials. You'd reach for this when Claude needs to answer questions like "which RSA assets are labeled LOW" or "who am I losing impression share to" rather than just listing campaigns and metrics.

GitHub stars
1
tools
5
auth
Secret needed
transport
STDIO
env vars
6
last updated
Apr 26, 2026
View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

GOOGLEADS_ADD_OR_REMOVE_TO_CUSTOMER_LISTAddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list.3 params

AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list.

Parameters* required
emailsarray
Array of emails of the contacts to be added to the customer list.
operationstring
Operation to be performed on the customer list. Either create or remove.one of create · removedefault: create
resource_namestring
Resource name of the customer list. For example: customers/1234567890/userLists/1234567890
GOOGLEADS_CREATE_CUSTOMER_LISTCreateCustomerList Tool will create a customer list in Google Ads.2 params

CreateCustomerList Tool will create a customer list in Google Ads.

Parameters* required
descriptionstring
Description of the customer list.
namestring
Name of the customer list.
GOOGLEADS_GET_CAMPAIGN_BY_IDGetCampaignById Tool will return details of a campaign in Google Ads.1 params

GetCampaignById Tool will return details of a campaign in Google Ads.

Parameters* required
idstring
id of the campaign to search on GoogleAds.
GOOGLEADS_GET_CAMPAIGN_BY_NAMEGetCampaignByName Tool will run a SQL GetCampaignByName in Google Ads.1 params

GetCampaignByName Tool will run a SQL GetCampaignByName in Google Ads.

Parameters* required
namestring
name of the campaign to search on GoogleAds.
GOOGLEADS_GET_CUSTOMER_LISTSGetCustomerLists Tool will list all customer lists in Google Ads.

GetCustomerLists Tool will list all customer lists in Google Ads.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

GOOGLE_ADS_DEVELOPER_TOKEN*secret

Google Ads developer token (apply at https://developers.google.com/google-ads/api/docs/get-started/dev-token)

GOOGLE_ADS_CLIENT_ID*secret

OAuth 2.0 client ID from Google Cloud Console

GOOGLE_ADS_CLIENT_SECRET*secret

OAuth 2.0 client secret from Google Cloud Console

GOOGLE_ADS_REFRESH_TOKEN*secret

OAuth 2.0 refresh token with https://www.googleapis.com/auth/adwords scope

GOOGLE_ADS_CUSTOMER_ID*

Default Google Ads customer ID (numeric, no dashes). Can be overridden per tool call.

GOOGLE_ADS_LOGIN_CUSTOMER_ID

Manager (MCC) account ID — required only if accessing accounts under an MCC

Readme

google-ads-mcp

npm version npm downloads glama score Node.js MCP License: MIT

MCP server for Google Ads — diagnose spend efficiency, impression share, and asset performance from Claude.

22 tools across campaigns, keywords, RSAs, assets, audiences, geo/device splits, impression share, auction insights, and budget pacing — plus a raw GAQL escape hatch. Built for B2B paid search teams and agencies running real diagnosis, not just dashboard-style "list my campaigns" queries.

Why this exists

View the full README on GitHub

Details

Repository
github.com/zleventer/google-ads-mcp
Category
Finance & Commerce
Package
@zleventer/google-ads-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Finance & Commerce MCP servers

View all
1adramp avatarGoogle Adsai.adramp/google-adsGoogle Ads MCP server — manage campaigns, keywords, and metrics.0stars
2adkit avatarGoogle Ads MCP Server by AdKitadkit/google-ads-mcpGoogle Ads MCP server: run Search, Display, Demand Gen and PMax campaigns from AI.0stars
3mharnett avatarGoogle Adsmharnett/mcp-google-adsGoogle Ads MCP with MCC support: 35 tools for campaigns, keywords, reporting, GAQL.0stars
4curievision avatarCurie Commercecurievision/curie-shopify-appSearch, compare in 3D, and buy products from 5.6M+ Shopify stores. Free tier; Pro adds checkout.0stars
5nirholas avatarDeFi Trading Agentsnirholas/defi-agentsDeFi agent definitions JSON API - crypto trading portfolio management bots32stars
6nirholas avatarCrypto Tools Registrynirholas/lyra-registryRegistry API for 800+ crypto blockchain DeFi NFT trading tools discovery0stars