google-ads-mcp-server
Summary: This is a read-first Google Ads MCP server that lets an MCP client explore accounts, analyze performance, run Keyword Planner research, and optionally make preview-gated write changes — 35 read tools plus 10 write tools that are disabled by default.
Read / analysis (enabled by default)
Accounts:
google_ads_list_accounts,google_ads_get_account_details,google_ads_get_account_hierarchy, andgoogle_ads_health_checkfor credential/connectivity verification.Core performance: campaigns, ad groups, keyword performance, budgets, bidding strategies, conversion actions, recommendations, and change events.
Search & traffic reports: search terms, paid/organic search terms, landing pages, and Shopping products/performance.
Performance Max: assets, placements, and asset-group diagnostics (including top combinations).
Creative libraries: image assets, video assets, Demand Gen assets, and video upload processing status.
Planning/forecasting: campaign, ad group, and portfolio bidding simulations.
Keyword Planner (RPC, outside GAQL): keyword ideas, historical search-volume metrics, forecast metrics, ad group themes, and geo target suggestions.
Query tooling:
google_ads_get_insights(auto-plans GAQL, splits incompatible queries),google_ads_validate_query(checks metric/dimension/resource compatibility first),google_ads_search_fields(live GoogleAdsField catalog), andgoogle_ads_run_gaqlfor raw queries.Escape hatch:
google_ads_run_readonly_rpcfor allowlisted read-only services GAQL can't reach — Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, invoices, payments accounts, identity verification.Model-readable resources: manifest, 130 metrics, 84 dimensions, compatibility matrix, and 11 workflow recipes.
Write actions (requires GOOGLE_ADS_ENABLE_WRITES=1, each previews before applying)
Campaign management: create campaign (always
PAUSED), pause/re-enable/remove, rename, change daily budget, change start/end schedule.Ad group management: pause/re-enable/remove, change default CPC bid.
Video: upload MP4/WebM/QuickTime bytes (max 16 MiB) and remove an account-owned upload.
Bulk:
google_ads_apply_planto preview, validate, and atomically apply a full v25 build/change plan (campaigns, budgets, ad groups, RSA/Display/Demand Gen ads, assets, PMax links, keywords, targeting).Safety: every write returns
applied: falseuntil repeated withconfirm: true; currency amounts are converted to micros and shown both ways.
Provides tools for reading and analyzing Google Ads data, including campaigns, ad groups, budgets, bidding strategies, search terms, landing pages, Performance Max assets and placements, Shopping, recommendations, and change history, plus Keyword Planner support and guarded write operations that preview changes before applying them.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-ads-mcp-server Show me campaign spend and conversions for last 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Ads MCP server
Turn Google Ads questions into useful answers.
Explore performance, research keywords and prepare campaign changes from your MCP client.
Watch the demo · What's new · Install · Tool reference · Try hosted getmcpads

Play the 27-second product film
The film demonstrates hosted getmcpads with staged data. Its creative galleries and MCP Apps interface belong to the hosted product. This repository provides the standalone native API tools.
35 read tools · 10 write tools, disabled by default.
Run locally with your own platform credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the platform. For managed connections, including supported ChatGPT setups, use the hosted option.
What's new
v2.0.0: Native tools and security update · September 20, 2026
Add descending image/video asset pagination.
Add account-scoped upload processing reads and return the native upload ID.
Retain API v25, standalone MCC discovery and credential redirect protection.
Require Node.js 22.12 or newer and check Node 22/24 in CI.
Update vulnerable dependencies and regenerate the MCP catalog.
Full changelog · Source synchronization details · All releases
Upgrade notes
Requires Node.js 22.12 or newer. CI covers Node 22 and 24. Version 2.0.0 drops Node 18 and 20 support. Read the current tool schemas before reusing saved arguments. Writes remain optional and require explicit confirmation. Hosted creative integrations and MCP Apps UI are outside this release.
Related MCP server: Google Ads MCP
Install this release
This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.
git clone --branch v2.0.0 --depth 1 https://github.com/getmcpads-com/google-ads-mcp-server.git
cd google-ads-mcp-server
npm ci
npm run buildConfigure your MCP client to run node with the absolute path to dist/cli.js and the platform credentials documented below.
Prefer a managed connection? Use Google Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.
What you get
35 read tools | Campaigns, ad groups, budgets, bidding strategies, search terms, landing pages, Performance Max assets and placements, Shopping, recommendations, change history |
10 write tools | Off by default. Status, budgets, bids, schedules, renames, campaign creation. Each one previews before it applies |
Full Keyword Planner | Keyword ideas, historical metrics, forecasts, ad group themes, geo target suggestions |
130 metrics, 84 dimensions | With a compatibility matrix that catches invalid combinations before they hit the API |
5 resources | Live catalogues the model can read: metrics, dimensions, compatibility rules, 11 workflow recipes |
GAQL and beyond |
|
You do not need to know GAQL
The Google Ads API is queried with GAQL, its own query language, and most of its surface is
only reachable that way. This server carries the metric and dimension catalogues, so the model
asks for cost and conversions by name and the server writes the query.
google_ads_validate_query lets it check a combination before spending a call on it, and
google_ads_run_gaql is still there when you want to write GAQL yourself.
Keyword Planner is not in GAQL
Keyword ideas, historical volumes and forecasts live in a separate RPC service that GAQL
cannot reach at all. Same for Reach Planner, audience insights and benchmarks. This server
covers them through google_ads_run_readonly_rpc and dedicated tools.
Getting credentials
This is the heaviest setup of any advertising platform. Four values are needed, and one of them requires a review by Google. Budget an hour the first time.
1. Developer token
From a manager (MCC) account, open Tools → API Center and apply for a token. It starts at Test Account level, which only reaches test accounts. Apply for Basic Access to reach live accounts. Google reviews the application, which can take a few days.
📖 Developer token documentation
2. OAuth client
In a Google Cloud project, enable the Google Ads API, then create an OAuth client under APIs & Services → Credentials. Choose Desktop app for local use. Note the client ID and client secret.
3. Refresh token
Run the OAuth consent flow once, signed in as the Google account that can see your ad accounts, and keep the refresh token it returns. Google's own helper script does this in one command.
The refresh token does not expire. It is the sensitive value here: anyone holding it can mint access tokens indefinitely. Treat it like a password, and use an OAuth client dedicated to this server so you can revoke it on its own.
4. Login customer ID, if you use a manager account
If the accounts you query sit under an MCC, set GOOGLE_ADS_LOGIN_CUSTOMER_ID to the manager
account ID. Dashes are accepted and stripped. Skip it for a standalone account.
You can also leave it unset. Google refuses any request against a managed account unless the
call names its manager, with a USER_PERMISSION_DENIED that mentions neither the account nor
the manager, so it reads as missing access rather than as a missing header. When the variable
is unset and the account you query is not directly accessible, the server asks the managers it
can reach which accounts they hold, and announces the one that holds yours. The answer is
resolved once and kept for the life of the process.
Setting the variable is still faster: it skips that discovery entirely, and it is the right choice when every account you query sits under the same MCC.
Run google_ads_health_check as your first call. It verifies all four credentials, lists
the accounts you can actually reach, and reports what is missing, without printing any secret.
Setup
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": ["-y", "@getmcpads/google-ads-mcp-server"],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
"GOOGLE_ADS_CLIENT_ID": "your-client-id",
"GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
"GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Restart Claude Desktop. Ask it: "list my Google Ads accounts".
Claude Code
claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=... --env GOOGLE_ADS_CLIENT_ID=... --env GOOGLE_ADS_CLIENT_SECRET=... --env GOOGLE_ADS_REFRESH_TOKEN=... -- npx -y @getmcpads/google-ads-mcp-serverCursor
.cursor/mcp.json in your project, same shape as the Claude Desktop config above.
From source
git clone https://github.com/getmcpads-com/google-ads-mcp-server.git
cd google-ads-mcp-server
npm install && npm run build
cp .env.example .env # then fill in your credentials
npm startConfiguration
Variable | Default | Meaning |
| none | Required. From the API Center, Basic Access or above |
| none | Required. OAuth client ID |
| none | Required. OAuth client secret |
| none | Required. From the consent flow |
| none | Optional. Manager (MCC) account ID. Resolved automatically when unset |
| unset | Set to |
|
|
|
Check your setup at any time:
npm run doctorWrites, and why they preview first
Write tools are disabled by default. Enable them with GOOGLE_ADS_ENABLE_WRITES=1.
Google's own server has none at all, so this is the part to read carefully.
When enabled, every write tool returns a preview and changes nothing:
// google_ads_update_campaign_budget { customerId: "123-456-7890", budgetId: "555", dailyAmount: 50 }
{
"applied": false,
"action": "google_ads_update_campaign_budget",
"change": { "customer": "1234567890", "budget": "555",
"newDailyBudget": 50, "inMicros": 50000000 },
"message": "Preview only, nothing was changed. Repeat the same call with confirm: true to apply this change to the live account."
}Only a second call carrying confirm: true touches the live account.
This is deliberate. An assistant composes these calls, and it can pick the wrong customer, the wrong campaign, or the wrong order of magnitude on a budget. A mandatory preview makes the mistake visible before it costs money, and gives a human the stopping point the protocol does not guarantee on its own.
Two further guardrails:
google_ads_create_campaignalways creates the campaignPAUSED. There is no option to create it active. Someone has to look at it before it spends.Amounts are converted to micros for you. Google holds money in millionths, so 12.50 in the account currency is
12500000. The preview shows both, so a factor-of-a-thousand mistake is visible before it applies.
Tool | What it changes |
| Pause, re-enable or remove |
| Daily budget |
| Default CPC bid |
| Start and end dates |
| Name only |
| Creates a budget, then a campaign, always |
Tools
Every tool is listed below. See server-card.json for complete parameter and output schemas.
Tool | Purpose |
| List Google Ads customer accounts accessible with the current credentials. |
| Get detailed information for a specific Google Ads customer account. |
| Execute a raw GAQL (Google Ads Query Language) query. |
| Query Google Ads performance insights with intelligent query planning. |
| List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy. |
| List ad groups for a Google Ads account, optionally filtered by campaign. |
| Get keyword-level performance data from keyword_view resource. |
| Validate metric/dimension/resource compatibility BEFORE executing a query. |
| Read-only connectivity check. |
| List accessible customers and, where possible, manager/client relationships from GAQL customer_client. |
| List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported. |
| Fetch recent change_event rows. |
| List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported. |
| List campaign budgets with amount, status, delivery method, and recommended budget fields when supported. |
| List portfolio bidding strategies. |
| Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType. |
| Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported. |
| List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics. |
| Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. |
| Read-only paid/organic search terms report. |
| Read-only Merchant Center product catalog/eligibility report via shopping_product. |
| Read-only Shopping performance report keyed by Merchant Center product dimensions. |
| Read-only Performance Max placement diagnostics from performance_max_placement_view. |
| Read-only Performance Max asset group diagnostics. |
| List the account's image asset library (FROM asset) with stable, publicly served full-size URLs on tpc.googlesyndication.com, dimensions, file size, and mime type. |
| List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs. |
| List Demand Gen ads (video responsive, multi-asset, carousel) with their referenced creatives resolved: stable image URLs and YouTube video IDs with embed and thumbnail URLs. |
| Get Keyword Planner search-volume history for supplied keywords. |
| Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. |
| Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. |
| Search Google's live GoogleAdsField catalog. |
| Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. |
| Organize supplied keywords into existing Google Ads ad groups. |
| Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. |
| Read the processing state and YouTube video ID of one Google Ads upload in the selected customer. |
Disabled by default. Calls preview unless explicitly confirmed. Check the configuration and exact schema before use.
Tool | Purpose |
| Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account. |
| Remove a video upload owned by the selected ad account. |
| Preview, validate and atomically apply a Google Ads v25 build/change plan: campaigns, budgets, ad groups, RSA/Display/Demand Gen ads, image/text/YouTube assets, PMax asset groups and links, keywords, geographic/language targeting listing groups and conversion action configuration (no conversion event uploads). |
| Pause, re-enable or remove a Google Ads campaign. |
| Create a Google Ads campaign. |
| Change the daily budget of a Google Ads campaign. |
| Rename a Google Ads campaign. |
| Change the start or end date of a Google Ads campaign. |
| Pause, re-enable or remove a Google Ads ad group. |
| Change the default CPC bid of a Google Ads ad group. |
URI | Contents |
| What this server exposes, and which tool to run first |
| All 130 metrics with categories and formats |
| All 84 dimensions and where they are valid |
| The compatibility matrix |
| 11 step-by-step workflows |
Security
This server holds a refresh token that never expires, a client secret and a developer token. Concretely:
None of the four credentials is ever logged, at any log level, or written to disk.
The access token is cached in memory until a minute before expiry, rather than re-requested on every call.
Two hosts are contacted, and only two:
googleads.googleapis.comandoauth2.googleapis.com. A test fails the build if a third host appears in the source.No fetch follows a redirect. Every outbound call sets
redirect: "error", so a redirect cannot forward a bearer token or client secret to another host. A test fails the build if any fetch omits this.No telemetry. The server makes no network call other than to Google.
Full policy and reporting instructions: SECURITY.md.
Looking for a managed, multi-platform version?
Try hosted Google Ads if you want to use this source without operating a local server. getmcpads also connects advertising, Search Console and GA4 through one MCP URL. Source availability and plan limits are listed on the site; connecting an account is still required.
Follow the Google Ads connection guide.
Select the account or property your assistant may read.
Try a read-only review: “Compare campaign spend and conversions across equal periods. State missing data and do not change anything.”
See the current hosted tool catalogue and pricing before choosing a paid plan. This Apache 2.0 adapter remains independently useful with your own credentials.
Contributing
Issues and pull requests are welcome. See CONTRIBUTING.md. Please read SECURITY.md before reporting anything security-related.
Licence
Apache License 2.0. See also NOTICE.
Google, Google Ads and the Google Ads API are trademarks of Google LLC. This project is not affiliated with, endorsed by, or sponsored by Google LLC. It is an independent client of a public API.
MCP contracts and desktop bundle
Every tool declares read/write annotations, parameter descriptions and a structured output schema. Successful calls expose the payload as structuredContent.result; errors retain isError: true. The generated server card contains definitions only.
Run npm run bundle -- /path/to/output to build a .mcpb desktop bundle from the current catalog. Credentials are entered locally during installation. Write tools remain disabled unless explicitly enabled.
More from getmcpads
Meta Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads
Maintained by Emmanuel at getmcpads. Questions: hello@getmcpads.com.
Available Tools
35 toolsgoogle_ads_generate_ad_group_themesgoogle ads generate ad group themesARead-onlyIdempotent
Organize supplied keywords into existing Google Ads ad groups. Returns suggested ad group/campaign pairings, normalized keyword text, and suggested match type without creating or editing keywords. Read-only Keyword Planner RPC.
Inputs: keywords (required), adGroupIds (required), customerId (required). Returns: result
google_ads_generate_keyword_forecast_metricsgoogle ads generate keyword forecast metricsARead-onlyIdempotent
Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports targeting, negatives, match type, three bidding strategies, explicit future dates, and an optional independent per-keyword breakdown. This read-only planless RPC does not create a campaign or saved plan.
Inputs: keywords (required), customerId (required), endDate, network, +14 more. Returns: result
google_ads_generate_keyword_historical_metricsgoogle ads generate keyword historical metricsARead-onlyIdempotent
Get Keyword Planner search-volume history for supplied keywords. Returns average monthly searches, monthly volumes (up to 48 months), latest volume, computed 3-month and YoY changes, competition, CPC/bid ranges, close variants, and optional device totals. This is a read-only planless RPC.
Inputs: keywords (required), customerId (required), network, languageId, +8 more. Returns: result
google_ads_generate_keyword_ideasgoogle ads generate keyword ideasARead-onlyIdempotent
Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. Returns historical volume, monthly trends, computed 3-month/YoY changes, competition, bids, close variants, optional concepts, and pagination. Read-only; no plan is saved.
Inputs: customerId (required), url, site, network, +12 more. Returns: result
google_ads_get_account_detailsgoogle ads get account detailsBRead-onlyIdempotent
Get detailed information for a specific Google Ads customer account.
Inputs: customerId (required). Returns: result
google_ads_get_account_hierarchygoogle ads get account hierarchyARead-onlyIdempotent
List accessible customers and, where possible, manager/client relationships from GAQL customer_client. Falls back to accessible customers if hierarchy queries are unavailable.
Inputs: includeInactive, managerCustomerId. Returns: result
google_ads_get_adgroupsgoogle ads get adgroupsARead-onlyIdempotent
List ad groups for a Google Ads account, optionally filtered by campaign.
Inputs: customerId (required), limit, campaignId, statusFilter. Returns: result
google_ads_get_bidding_strategiesgoogle ads get bidding strategiesARead-onlyIdempotent
List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.
Inputs: customerId (required), limit, endDate, startDate, +1 more. Returns: result
google_ads_get_budgetsgoogle ads get budgetsARead-onlyIdempotent
List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.
Inputs: customerId (required), limit, statusFilter. Returns: result
google_ads_get_campaignsgoogle ads get campaignsARead-onlyIdempotent
List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.
Inputs: customerId (required), limit, statusFilter. Returns: result
google_ads_get_change_eventsgoogle ads get change eventsARead-onlyIdempotent
Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.
Inputs: customerId (required), limit, endDate, operation, +3 more. Returns: result
google_ads_get_conversion_actionsgoogle ads get conversion actionsARead-onlyIdempotent
List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported.
Inputs: customerId (required), limit, statusFilter. Returns: result
google_ads_get_demand_gen_assetsgoogle ads get demand gen assetsARead-onlyIdempotent
List Demand Gen ads (video responsive, multi-asset, carousel) with their referenced creatives resolved: stable image URLs and YouTube video IDs with embed and thumbnail URLs. Complements google_ads_get_pmax_assets, which covers Performance Max.
Inputs: customerId (required), limit, campaignId. Returns: result
google_ads_get_insightsgoogle ads get insightsARead-onlyIdempotent
Query Google Ads performance insights with intelligent query planning. Auto-generates GAQL, handles metric/segment incompatibilities by splitting queries. Use google-ads://metrics for available metrics, google-ads://dimensions for dimensions.
Inputs: metrics (required), customerId (required), limit, endDate, +6 more. Returns: result
google_ads_get_keyword_performancegoogle ads get keyword performanceARead-onlyIdempotent
Get keyword-level performance data from keyword_view resource. Shows quality score, impressions, clicks, cost.
Inputs: endDate (required), startDate (required), customerId (required), limit. Returns: result
google_ads_get_landing_pagesgoogle ads get landing pagesBRead-onlyIdempotent
Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported.
Inputs: endDate (required), startDate (required), customerId (required), limit, +1 more. Returns: result
google_ads_get_paid_organic_search_termsgoogle ads get paid organic search termsARead-onlyIdempotent
Read-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.
Inputs: endDate (required), startDate (required), customerId (required), limit, +4 more. Returns: result
google_ads_get_pmax_asset_diagnosticsgoogle ads get pmax asset diagnosticsARead-onlyIdempotent
Read-only Performance Max asset group diagnostics. Returns ad strength, asset coverage action items, primary status reasons, optional performance metrics, and optional top asset combinations.
Inputs: customerId (required), limit, endDate, startDate, +4 more. Returns: result
google_ads_get_pmax_assetsgoogle ads get pmax assetsARead-onlyIdempotent
List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics.
Inputs: customerId (required), daily, limit, assetId, +8 more. Returns: result
google_ads_get_pmax_placementsgoogle ads get pmax placementsARead-onlyIdempotent
Read-only Performance Max placement diagnostics from performance_max_placement_view. Returns placement type, display name, target URL, campaign context, and impressions only.
Inputs: endDate (required), startDate (required), customerId (required), limit, +3 more. Returns: result
google_ads_get_recommendationsgoogle ads get recommendationsARead-onlyIdempotent
List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.
Inputs: customerId (required), limit, typeFilter, includeDismissed. Returns: result
google_ads_get_search_termsgoogle ads get search termsBRead-onlyIdempotent
Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
Inputs: endDate (required), startDate (required), customerId (required), limit, +4 more. Returns: result
google_ads_get_shopping_performancegoogle ads get shopping performanceARead-onlyIdempotent
Read-only Shopping performance report keyed by Merchant Center product dimensions. Useful for joining spend/conversions to merchant ID, item ID, title, brand, feed label, and custom labels.
Inputs: endDate (required), startDate (required), customerId (required), brand, +7 more. Returns: result
google_ads_get_shopping_productsgoogle ads get shopping productsARead-onlyIdempotent
Read-only Merchant Center product catalog/eligibility report via shopping_product. Supports account, campaign, and ad group scopes with performance metrics when the account has Shopping/PMax e-commerce data.
Inputs: customerId (required), limit, scope, itemId, +8 more. Returns: result
google_ads_get_simulationsgoogle ads get simulationsARead-onlyIdempotent
Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. Returns simulation metadata and projected point lists when available, with a metadata fallback.
Inputs: customerId (required), level, limit, adGroupId, +6 more. Returns: result
google_ads_get_video_uploadgoogle ads get video uploadARead-onlyIdempotent
Read the processing state and YouTube video ID of one Google Ads upload in the selected customer. Use only the returned videoId after state=PROCESSED. This is a read; it does not upload again.
Inputs: currency (required), uploadId (required), customerId (required), loginCustomerId, +1 more. Returns: result
google_ads_health_checkgoogle ads health checkARead-onlyIdempotent
Read-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.
Inputs: no named parameters. Returns: result
google_ads_list_accountsgoogle ads list accountsARead-onlyIdempotent
List Google Ads customer accounts accessible with the current credentials. If an accessible customer is a manager account, also attempts to include enabled child accounts from customer_client.
Inputs: no named parameters. Returns: result
google_ads_list_image_assetsgoogle ads list image assetsARead-onlyIdempotent
List the account's image asset library (FROM asset) with stable, publicly served full-size URLs on tpc.googlesyndication.com, dimensions, file size, and mime type. This is the whole stock and carries no notion of delivery: an asset uploaded in 2022 and never served appears exactly like one running today. Newest first, so a limit returns recent assets rather than an arbitrary slice, and the count in the response is the account total. For a visual-only gallery of assets with delivery over dates, use the hosted GetMCPAds service (Performance Max coverage). The local server returns media URLs and native report data. Shopping product imagery lives in Merchant Center, not in this library.
Inputs: customerId (required), limit, assetIds, minWidth, +3 more. Returns: result
google_ads_list_video_assetsgoogle ads list video assetsARead-onlyIdempotent
List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs. This is the whole stock and carries no notion of delivery: an asset uploaded years ago and never served appears exactly like one running today. Newest first, so a limit returns recent assets rather than an arbitrary slice, and the count in the response is the account total. For a visual-only gallery of assets with delivery over dates, use the hosted GetMCPAds service (Performance Max coverage). The local server returns media URLs and native report data. Google Ads exposes no downloadable video file: PMax and Demand Gen videos are hosted on YouTube, so display them via embed or thumbnails.
Inputs: customerId (required), limit, assetIds, nameFilter, +1 more. Returns: result
google_ads_run_gaqlgoogle ads run gaqlARead-onlyIdempotent
Execute a raw GAQL (Google Ads Query Language) query. Full flexibility for any reporting need. Example: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100
Inputs: query (required), customerId (required). Returns: result
google_ads_run_readonly_rpcgoogle ads run readonly rpcARead-onlyIdempotent
Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. The operation is an enum; arbitrary paths and all mutations/uploads are impossible.
Inputs: operation (required), request, customerId. Returns: result
google_ads_search_fieldsgoogle ads search fieldsARead-onlyIdempotent
Search Google's live GoogleAdsField catalog. Discovers every queryable GAQL resource, attribute, segment, metric, enum value, and selectable-with compatibility relationship. Read-only and useful before a raw GAQL query.
Inputs: query, category, pageSize, sortable, +4 more. Returns: result
google_ads_suggest_geo_targetsgoogle ads suggest geo targetsARead-onlyIdempotent
Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. Returns criterion IDs, canonical names, target types, status, parents, locale, and approximate reach. Read-only.
Inputs: locale, countryCode, geoTargetIds, locationNames. Returns: result
google_ads_validate_querygoogle ads validate queryARead-onlyIdempotent
Validate metric/dimension/resource compatibility BEFORE executing a query. Checks segment restrictions and resource availability.
Inputs: metrics (required), resource, dimensions. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 35 tools
Most tools target distinct Google Ads resources or operations, and descriptions clarify their scope. However, the presence of both raw query tools (run_gaql, run_readonly_rpc) and numerous specific reporting tools creates some overlap that could confuse agents choosing between convenience and flexibility.
All tool names use a consistent google_ads_ prefix followed by snake_case verbs and nouns. The pattern is highly predictable, with only minor variations like health_check that do not hinder readability.
35 tools is excessive for the apparent scope; many specific report tools duplicate what run_gaql can already achieve. The set could be significantly consolidated without loss of core functionality.
The read-only surface is broad, covering accounts, campaigns, ad groups, keywords, shopping, PMax, Demand Gen, keyword planning, and validation. Raw GAQL and readonly RPC fill most gaps, but direct ad-level reporting and certain niche reports are not exposed as dedicated tools.
Maintenance
Related MCP Connectors
Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Google Ads for AI agents: live reports, Keyword Planner, and changes with preview, confirm and undo.
Run Google Ads, Meta, TikTok, LinkedIn, GA4 & Search Console from chat. Changes wait for approval.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables comprehensive Google Ads campaign management and analysis through natural language, including performance metrics, keyword optimization, budget management, and custom GAQL queries.10017MIT
- AlicenseAqualityFmaintenanceEnables managing Google Ads campaigns through an AI assistant with read-only reporting, recommendations, and gated write operations for bids, budgets, and statuses, all backed by preview and audit logging.311MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query campaign performance, metrics, audiences, and geography, and to analyze budgets, wasted spend, and account health through natural language.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables natural-language analysis and management of Google Ads accounts, campaigns, keywords, budgets, and performance metrics through Claude.MIT