google-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOOGLE_ADS_CLIENT_ID | Yes | OAuth 2.0 client ID | |
| GOOGLE_ADS_CUSTOMER_ID | Yes | Default customer ID (no dashes). Can be overridden per tool call. | |
| GOOGLE_ADS_CLIENT_SECRET | Yes | OAuth 2.0 client secret | |
| GOOGLE_ADS_REFRESH_TOKEN | Yes | OAuth 2.0 refresh token | |
| GOOGLE_ADS_DEVELOPER_TOKEN | Yes | Your Google Ads developer token | |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | No | Manager account ID for MCC access |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gads_run_gaqlA | Escape hatch: run any raw GAQL query against Google Ads. Use when preset tools don't cover the report shape you need. Docs: developers.google.com/google-ads/api/docs/query/overview |
| gads_list_accountsA | List all Google Ads customer accounts the authenticated user has access to. Useful for finding customer IDs. |
| gads_account_infoA | Get basic info for the current Google Ads account: name, currency, timezone, manager flag, status. |
| gads_list_campaignsB | List campaigns in the account with name, status, channel type, bidding strategy, and date range. Filter by status (default ENABLED). |
| gads_campaign_performanceA | Campaign-level performance: impressions, clicks, CTR, avg CPC, cost, conversions, conv value, CPA, ROAS. Defaults to last 28 days, enabled campaigns, sorted by cost desc. |
| gads_ad_group_performanceB | Ad group performance with campaign context. Optional campaign_id filter. Default last 28 days, enabled ad groups. |
| gads_keyword_performanceA | Keyword-level performance with match type, quality score, clicks, cost, conversions. Filter by campaign_id or ad_group_id. Default last 28 days, enabled keywords. |
| gads_search_terms_reportA | Search terms that triggered ads (the actual user queries, not your keywords). Essential for finding wasted spend and negative keyword candidates. Default last 28 days. |
| gads_conversions_by_campaignB | Conversions and conversion value broken down by campaign × conversion action. Sorted by conversions desc. Default last 28 days. |
| gads_list_conversion_actionsC | List all conversion actions configured in the account: name, category, type, whether included in Conversions metric, counting type. |
| gads_list_rsasB | List Responsive Search Ads with all headlines, descriptions, Ad Strength rating, and approval status. Filter by campaign or ad group. |
| gads_rsa_asset_performanceA | Asset-level performance labels (BEST / GOOD / LOW / PENDING / LEARNING) for RSA headlines and descriptions. Identifies which assets to keep, test, or replace. |
| gads_list_assetsB | List account-level assets: sitelinks, callouts, structured snippets, images, call extensions, and more. Filter by asset type. |
| gads_campaign_assetsA | Assets linked to campaigns with field type and status. Shows which extensions are active on which campaigns. |
| gads_list_audiencesB | List user lists (remarketing audiences, customer match lists) in the account with size, eligibility, and match rate. |
| gads_campaign_audience_targetingA | Audiences attached to campaigns with targeting setting (observation vs targeting) and bid modifier. Shows both inclusion and exclusion lists. |
| gads_geo_performanceB | Performance broken down by geographic location (country, region, city). Surfaces top and bottom geo segments by cost and conversions. |
| gads_device_performanceA | Clicks, cost, CTR, conversions, and CPA split by MOBILE / DESKTOP / TABLET per campaign. Default last 28 days. |
| gads_impression_shareA | Search Impression Share, Lost IS (Budget), and Lost IS (Rank) per campaign. Identifies whether budget or Quality Score/bid is limiting reach. |
| gads_auction_insightsB | Auction Insights report: impression share, overlap rate, outranking share, top-of-page %, and absolute top % vs competitors. Optional campaign filter. |
| gads_list_budgetsB | All campaign budgets with daily/total amount, delivery method (STANDARD/ACCELERATED), period, and whether a recommended budget exists. |
| gads_budget_pacingA | Cost vs budget per campaign for the specified period with utilization percentage. Flags over- and under-pacing campaigns. Default last 28 days. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/google-ads-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server