All servers / Marketing / Google Ads MCP server
Google Ads MCP server
MCP server for Google Ads API with MCC support, 85 tools for campaign management, reporting, and optimization. Read-only by default -- mutating tools require GO
Tested by ConnectATDScore 84 out of 100. Tested 2026-11-19 on package version 1.13.0. Package: mcp-google-ads · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (6.0 seconds including download)
- Tools offered: 21
- Last published: 2026-11-13
- Weekly downloads (npm): 694
- License: MIT · Direct dependencies: 11
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
google_ads_get_client_context1 of 1 parameter describedGet the current client context and health status based on working directory. Call this first to confirm which Google Ads account you're working with.
google_ads_list_campaigns1 of 1 parameter describedList all campaigns for the current client account Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_list_ad_groups0 of 2 parameters describedList ad groups, optionally filtered by campaign Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_get_campaign_tracking1 of 2 parameters describedGet campaign tracking parameters including tracking URL template, final URL suffix, and custom URL parameters
google_ads_list_pending_changes0 of 1 parameter describedList all pending changes (paused items with claude- label) awaiting review
google_ads_validate_ad6 of 7 parameters describedValidate an RSA without creating it. Use this to check for errors before creating. Enforces: 3-15 headlines (≤30 chars), 2-4 descriptions (≤90 chars), ≥1 final URL, both path1 AND path2 present (≤15 chars each), ≥1 label. Also enforces a house floor of ≥15 headlines and ≥4 descriptions by default (mirroring google_ads_create_responsive_search_ad's pre-check) -- pass allow_partial_assets: true to preview a below-floor ad without that rejection.
google_ads_keyword_performance5 of 6 parameters describedGet keyword performance report with metrics including impressions, clicks, cost, conversions, quality score components (quality score, expected CTR, ad relevance, landing page experience), and impression share metrics. Includes paused and removed keywords that had activity in the date range (status column labels them) — historical metrics are never filtered by current status. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_keyword_performance_by_conversion5 of 6 parameters describedGet keyword performance broken down by conversion action. Shows which keywords drive which conversion types (e.g., form fills, MQLs, etc.). Includes paused and removed keywords that had activity in the date range (status column labels them) — historical metrics are never filtered by current status. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_search_term_report6 of 7 parameters describedGet search term report showing actual search queries that triggered ads, with the keyword they matched to. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_search_term_report_by_conversion6 of 7 parameters describedGet search term report broken down by conversion action. Shows which search queries drive which conversion types. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_ad_performance4 of 5 parameters describedGet ad performance report with metrics, ad copy (headlines/descriptions), final URLs, and ad strength rating. Includes paused and removed ads that had activity in the date range (status column labels them) — historical metrics are never filtered by current status. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_ad_performance_by_conversion4 of 5 parameters describedGet ad performance broken down by conversion action. Shows which ads drive which conversion types. Includes paused and removed ads that had activity in the date range (status column labels them) — historical metrics are never filtered by current status. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_list_conversion_actions0 of 1 parameter describedList all available conversion actions (e.g., form fills, MQLs, etc.) to understand what conversion tracking is set up. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_search_term_insights5 of 6 parameters describedGet search term category insights for a campaign. Shows the search categories your ads appeared against (like the Insights panel in the Google Ads UI). Must query one campaign at a time. Optionally compares two date ranges to show trends.
google_ads_search_term_insight_terms4 of 5 parameters describedDrill into a specific search term category to see the individual search terms within it. Requires an insight_id from google_ads_search_term_insights. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_get_campaign_diagnostics1 of 2 parameters describedDiagnose why a campaign is not spending or serving. Returns primary_status, primary_status_reasons, serving_status, budget, bidding strategy, and last-7-days metrics in a single call. Use this as the first step when a campaign has unexpectedly low spend or impressions. Includes paused and removed campaigns that had activity in the date range (status column labels them) — historical metrics are never filtered by current status. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_get_ad_strength2 of 3 parameters describedGet the ad strength rating (POOR, AVERAGE, GOOD, EXCELLENT) for RSAs in a campaign or ad group, along with headline/description counts. Ad strength below GOOD suppresses delivery. Use this to identify ads that need more creative assets. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL, so counts or totals computed from it are understated. Narrow the date range or filters and re-run until truncated is absent.
google_ads_gaql_query1 of 2 parameters describedExecute a raw GAQL (Google Ads Query Language) query. Use this for custom reports or accessing any Google Ads API resource not covered by other tools. See https://developers.google.com/google-ads/api/docs/query/overview for GAQL syntax. Returns an array of rows. If the result is too large for one response it is cut and returned as { rows, truncated: true, original_count, returned_count } instead: that result is PARTIAL (only returned_count of original_count rows), so never treat it as complete or sum totals from it. Narrow the query (fewer fields, a tighter WHERE or date range, or a LIMIT) and re-run until truncated is absent.
google_ads_keyword_volume4 of 4 parameters describedGet historical search volume estimates for a list of keywords using the Google Ads Keyword Planner. Returns avg monthly searches, competition level, and CPC bid range for each keyword.
google_ads_list_experiments2 of 3 parameters describedList all experiments in the account, optionally filtered by base campaign ID.
google_ads_get_experiment1 of 2 parameters describedGet full details for an experiment including its arms and treatment campaign ID.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.