Google Ads

Google Ads MCP server: 35 read tools, 13 opt-in preview-first writes.

Connector by getmcpads.com · Domain verified by the MCP Registry

IndexedApache-2.0Local (stdio)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/getmcpads-com-google-ads

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Google Ads MCP server: 35 read tools, 13 opt-in preview-first writes.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 32 read · 12 write · 3 delete · 1 not yet classified
Secrets: 3 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 48

Read from the source code; the running server may list different tools.

Read 32 · Look things up without changing anything.

google_ads_generate_keyword_forecast_metrics
google_ads_generate_keyword_historical_metrics
google_ads_generate_keyword_ideas
google_ads_get_account_details
google_ads_get_account_hierarchy
google_ads_get_adgroups
google_ads_get_bidding_strategies
google_ads_get_budgets
google_ads_get_campaigns
google_ads_get_change_events
google_ads_get_conversion_actions
google_ads_get_demand_gen_assets

Show 20 more tools

google_ads_get_insights
google_ads_get_keyword_performance
google_ads_get_landing_pages
google_ads_get_paid_organic_search_terms
google_ads_get_pmax_asset_diagnostics
google_ads_get_pmax_assets
google_ads_get_pmax_placements
google_ads_get_recommendations
google_ads_get_search_terms
google_ads_get_shopping_performance
google_ads_get_shopping_products
google_ads_get_simulations
google_ads_get_video_upload
google_ads_health_check
google_ads_list_accounts
google_ads_list_image_assets
google_ads_list_video_assets
google_ads_search_fields
google_ads_suggest_geo_targets
google_ads_validate_query

Write 12 · Create, change, send or run things.

google_ads_apply_plan
google_ads_create_campaign
google_ads_rename_account
google_ads_rename_adgroup
google_ads_rename_asset_group
google_ads_rename_campaign
google_ads_run_gaql
google_ads_run_readonly_rpc
google_ads_update_adgroup_bid
google_ads_update_campaign_budget
google_ads_update_campaign_schedule
google_ads_upload_video

Delete 3 · Delete, drop, revoke or wipe things.

google_ads_remove_video_upload
google_ads_update_adgroup_status
google_ads_update_campaign_status

Not yet classified 1 · We could not tell from the name and description.

google_ads_generate_ad_group_themes

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

GOOGLE_ADS_CLIENT_SECRET
GOOGLE_ADS_DEVELOPER_TOKEN
GOOGLE_ADS_REFRESH_TOKEN

Other settings (environment variables or headers).

GOOGLE_ADS_ACCOUNT_IDS
GOOGLE_ADS_CLIENT_ID
GOOGLE_ADS_ENABLE_WRITES
GOOGLE_ADS_LOGIN_CUSTOMER_ID

Tools (48)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

google_ads_apply_plan
Preview, validate and atomically apply a Google Ads v26 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). Native REST camelCase fields; amounts are integer micros of the explicitly stated currency. Supports temporary negative resource IDs for ordered creation in one transaction. No VIDEO campaign creation (Google API restriction), billing, account access changes, customer lists or conversion…
google_ads_create_campaign
Create a Google Ads campaign. It is always created PAUSED and there is no option to create it active: someone has to look at it before it spends. Creates the campaign budget too. Previews by default.
google_ads_generate_ad_group_themes
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.
google_ads_generate_keyword_forecast_metrics
Forecast clicks, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports location and language targeting, 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.
google_ads_generate_keyword_historical_metrics
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.
google_ads_generate_keyword_ideas
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.
google_ads_get_account_details
Get detailed information for a specific Google Ads customer account.
google_ads_get_account_hierarchy
List accessible customers and, where possible, manager/client relationships from GAQL customer_client. Falls back to accessible customers if hierarchy queries are unavailable.
google_ads_get_adgroups
List ad groups for a Google Ads account, optionally filtered by campaign.
google_ads_get_bidding_strategies
List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.
google_ads_get_budgets
List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.
google_ads_get_campaigns
List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.
google_ads_get_change_events
Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.
google_ads_get_conversion_actions
List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported.
google_ads_get_demand_gen_assets
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.

Show 33 more tools

google_ads_get_insights
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.
google_ads_get_keyword_performance
Get keyword-level performance data from keyword_view resource. Shows quality score, impressions, clicks, cost.
google_ads_get_landing_pages
Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported.
google_ads_get_paid_organic_search_terms
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.
google_ads_get_pmax_asset_diagnostics
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.
google_ads_get_pmax_assets
List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics.
google_ads_get_pmax_placements
Read-only Performance Max placement diagnostics from performance_max_placement_view. Returns placement type, display name, target URL, campaign context, and impressions only.
google_ads_get_recommendations
List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.
google_ads_get_search_terms
Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
google_ads_get_shopping_performance
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.
google_ads_get_shopping_products
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.
google_ads_get_simulations
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.
google_ads_get_video_upload
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.
google_ads_health_check
Read-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.
google_ads_list_accounts
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.
google_ads_list_image_assets
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 …
google_ads_list_video_assets
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 …
google_ads_remove_video_upload
Remove a video upload owned by the selected ad account. Deletes the uploaded YouTube video and can break ads referencing it. Preview and matching expectedPlanHash required. Google v26 marks title/description immutable; this tool does not pretend to edit them.
google_ads_rename_account
Rename a Google Ads account (its descriptive name). Nothing else changes. Previews by default.
google_ads_rename_adgroup
Rename a Google Ads ad group. The name is the only thing that changes: delivery, bids and assets are untouched. Previews by default.
google_ads_rename_asset_group
Rename a Google Ads Performance Max asset group. The name is the only thing that changes: delivery, bids and assets are untouched. Previews by default.
google_ads_rename_campaign
Rename a Google Ads campaign. The name is the only thing that changes: delivery, budget and targeting are untouched. Previews by default.
google_ads_run_gaql
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
google_ads_run_readonly_rpc
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.
google_ads_search_fields
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.
google_ads_suggest_geo_targets
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.
google_ads_update_adgroup_bid
Change the default CPC bid of a Google Ads ad group. The amount is in the account currency (1.20 for 1.20 EUR). Has no effect on a campaign using an automated bidding strategy. Previews by default.
google_ads_update_adgroup_status
Pause, re-enable or remove a Google Ads ad group. Previews by default.
google_ads_update_campaign_budget
Change the daily budget of a Google Ads campaign. The amount is in the account currency (12.50 for 12.50 EUR). Previews by default.
google_ads_update_campaign_schedule
Change the start or end date of a Google Ads campaign. Dates are YYYY-MM-DD in the account time zone. Previews by default.
google_ads_update_campaign_status
Pause, re-enable or remove a Google Ads campaign. Previews by default: without confirm: true, the tool describes the change without applying it.
google_ads_upload_video
Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account. Visibility is UNLISTED: viewable by anyone with the link, not private. Default preview omits bytes and returns planHash; confirm requires expectedPlanHash. This API has no validateOnly. After upload, query you_tube_video_upload.state and video_id with google_ads_run_gaql; only use the video ID after PROCESSED, via google_ads_apply_plan assetOperation.youtubeVideoAsset. No automatic retry after an uncertain upload.
google_ads_validate_query
Validate metric/dimension/resource compatibility BEFORE executing a query. Checks segment restrictions and resource availability.

Compare and alternatives

Featured in

Best MCP servers for Google Ads

Signals

Stars: 0
Forks: 0
Open issues: 0
Weekly downloads: 50
Last commit: Oct 23, 2026 (5 days ago)
Last release: Oct 23, 2026 (5 days ago)
Last package publish: Oct 23, 2026 (5 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: com.getmcpads/google-ads
Version: 2.1.0
Auth: API key
Packages: npm @getmcpads/google-ads-mcp-server
License: Apache-2.0
Repository: github.com/get-mcp-ads/google-ads-mcp-server
Website: www.getmcpads.com/tools/google-ads
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

More from getmcpads.com

Cite this page

Google Ads MCP server. Agent Mart. https://agentmart.dev/connectors/getmcpads-com-google-ads (last updated 2026-10-24)