# Google Ads [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/get-mcp-ads/google-ads-mcp-server  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/google-ads-10

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

## Tools
Capabilities this server exposes over MCP:

- **google_ads_list_accounts** — List Google Ads customer accounts accessible with the current credentials.
- **google_ads_get_account_details** — Get detailed information for a specific Google Ads customer account.
- **google_ads_run_gaql** — Execute a raw GAQL (Google Ads Query Language) query.
- **google_ads_get_insights** — Query Google Ads performance insights with intelligent query planning.
- **google_ads_get_campaigns** — List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.
- **google_ads_get_adgroups** — List ad groups for a Google Ads account, optionally filtered by campaign.
- **google_ads_get_keyword_performance** — Get keyword-level performance data from keyword_view resource.
- **google_ads_validate_query** — Validate metric/dimension/resource compatibility BEFORE executing a query.
- **google_ads_health_check** — Read-only connectivity check.
- **google_ads_get_account_hierarchy** — List accessible customers and, where possible, manager/client relationships from GAQL customer_client.
- **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_change_events** — Fetch recent change_event rows.
- **google_ads_get_recommendations** — List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.
- **google_ads_get_budgets** — List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.
- **google_ads_get_bidding_strategies** — List portfolio bidding strategies.
- **google_ads_get_search_terms** — Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
- **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_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_simulations** — Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations.
- **google_ads_get_paid_organic_search_terms** — Read-only paid/organic search terms report.
- **google_ads_get_shopping_products** — Read-only Merchant Center product catalog/eligibility report via shopping_product.
- **google_ads_get_shopping_performance** — Read-only Shopping performance report keyed by Merchant Center product dimensions.
- **google_ads_get_pmax_placements** — Read-only Performance Max placement diagnostics from performance_max_placement_view.
- **google_ads_get_pmax_asset_diagnostics** — Read-only Performance Max asset group diagnostics.
- **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.
- **google_ads_list_video_assets** — List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs.
- **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.
- **google_ads_generate_keyword_historical_metrics** — Get Keyword Planner search-volume history for supplied keywords.
- **google_ads_generate_keyword_ideas** — Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site.
- **google_ads_generate_keyword_forecast_metrics** — Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.
- **google_ads_search_fields** — Search Google's live GoogleAdsField catalog.
- **google_ads_suggest_geo_targets** — Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants.
- **google_ads_generate_ad_group_themes** — Organize supplied keywords into existing Google Ads ad groups.
- **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.
- **google_ads_get_video_upload** — Read the processing state and YouTube video ID of one Google Ads upload in the selected customer.
- **google_ads_upload_video** — Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account.
- **google_ads_remove_video_upload** — Remove a video upload owned by the selected ad account.
- **google_ads_apply_plan** — 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 eve…
- **google_ads_update_campaign_status** — Pause, re-enable or remove a Google Ads campaign.
- **google_ads_create_campaign** — Create a Google Ads campaign.
- **google_ads_update_campaign_budget** — Change the daily budget of a Google Ads campaign.
- **google_ads_rename_campaign** — Rename a Google Ads campaign.
- **google_ads_update_campaign_schedule** — Change the start or end date of a Google Ads campaign.
- **google_ads_update_adgroup_status** — Pause, re-enable or remove a Google Ads ad group.
- **google_ads_update_adgroup_bid** — Change the default CPC bid of a Google Ads ad group.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What Google Ads MCP server does

The Google Ads MCP server exposes native Google Ads API operations through MCP. It is intended for local use with your own platform credentials, with requests sent directly to Google Ads. The repository provides 35 read tools and 10 write tools that are disabled by default. Write operations require explicit confirmation and show a preview before changes are applied.

Read access covers customer accounts, account hierarchy, account details, campaigns, ad groups, budgets, bidding strategies, conversion actions, recommendations, change events, and health checks. Reporting tools retrieve keyword performance, search terms, landing-page metrics, paid and organic search terms, Shopping data, Performance Max placements and diagnostics, and asset information. Image and video tools return asset metadata and usable image or YouTube-related URLs when supported by the underlying account data.

The Google Ads MCP server also includes Keyword Planner operations for keyword ideas, historical search-volume metrics, and temporary campaign forecasts. This makes it relevant to the 🎯 Marketing category for account analysis, campaign research, and planning workflows.

## How it works

An MCP client invokes a tool, and the server translates the request into Google Ads API calls. `google_ads_run_gaql` accepts raw Google Ads Query Language queries for cases where a dedicated tool is not sufficient. Dedicated reporting tools can plan queries from requested metrics and dimensions, while `google_ads_validate_query` checks compatibility before execution.

Keyword ideas, historical metrics, and forecasts use Google Ads services outside the GAQL query surface, so they are exposed through dedicated tools rather than raw GAQL. The health-check tool verifies credentials and reports which accessible accounts can be reached without printing secrets.

For manager-account access, the optional login customer ID identifies the MCC used for requests. If it is omitted, the server can discover reachable managers and retain the result for the process lifetime.

## Setup and configuration

Version 2.0.1 requires Node.js 22.12 or newer. A source installation uses `git clone`, `npm ci`, and `npm run build`; the MCP client then runs the built `dist/cli.js` with an absolute path. The README also documents an `npx` configuration for the published package.

Local setup requires a Google Ads developer token, OAuth client ID, OAuth client secret, and refresh token. The developer token must come from a manager account and needs suitable access for live accounts. The OAuth client is created in a Google Cloud project with the Google Ads API enabled. A refresh token is obtained through the OAuth consent flow and should be protected as a secret.

Set `GOOGLE_ADS_LOGIN_CUSTOMER_ID` when querying accounts under a manager account. After configuration, run `google_ads_health_check` before other requests to identify missing credentials or inaccessible accounts.

## Tools and capabilities

- List accessible accounts and manager/client relationships.
- Inspect campaigns, ad groups, budgets, bids, conversions, recommendations, and account changes.
- Query performance by keyword, search term, landing page, Shopping product, or Performance Max placement.
- List image, video, Demand Gen, and Performance Max asset information.
- Validate and execute GAQL queries.
- Generate keyword ideas, historical metrics, and forecast metrics.
- Prepare supported account changes through opt-in, preview-first write tools.

_Full upstream README: https://allmcps.com/mcp/google-ads-10/readme_