# Google Ads [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/get-mcp-ads/google-ads-mcp-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 781  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/google-ads-6

## Description
Google Ads: 31 read tools with full Keyword Planner, 7 write tools that preview first.

## 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
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "google-ads": {
    "command": "npx",
    "args": ["-y","@getmcpads/google-ads-mcp-server"],
    "env": {
      "GOOGLE_ADS_DEVELOPER_TOKEN": "",
      "GOOGLE_ADS_CLIENT_ID": "",
      "GOOGLE_ADS_CLIENT_SECRET": "",
      "GOOGLE_ADS_REFRESH_TOKEN": "",
      "GOOGLE_ADS_LOGIN_CUSTOMER_ID": ""
    }
  }
}
```

**Requires environment variables:** `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CLIENT_ID`, `GOOGLE_ADS_CLIENT_SECRET`, `GOOGLE_ADS_REFRESH_TOKEN`, `GOOGLE_ADS_LOGIN_CUSTOMER_ID` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the Google Ads MCP server does

The Google Ads MCP server exposes Google Ads account and reporting operations through MCP. It can list accessible customer accounts, inspect account relationships, retrieve campaigns, ad groups, budgets, bidding strategies, conversion actions, recommendations, and recent change events. Performance tools cover keywords, search terms, landing pages, Shopping products, paid and organic search, Performance Max placements and assets, and Demand Gen creatives.

The server also includes Keyword Planner operations. Agents can generate keyword ideas from seed terms, URLs, keywords combined with URLs, or an entire site; retrieve historical search-volume metrics; and forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.

Read operations are the main interface. The repository also supports optional write operations for campaign changes, but writes are disabled by default and preview the proposed change before applying it.

## How it works

The Google Ads MCP server sends requests directly to the Google Ads platform using credentials supplied by the operator. Structured tools handle common reports, while `google_ads_run_gaql` accepts raw Google Ads Query Language for custom queries. `google_ads_validate_query` checks metric, dimension, and resource compatibility before execution, helping avoid invalid API combinations.

Some Google Ads services are not available through GAQL. Dedicated Keyword Planner tools cover the documented planning workflows, while the broader source release also describes a read-only RPC path for services outside GAQL. The health check verifies credentials and reports reachable accounts without exposing secrets.

Asset tools return account image assets, YouTube video assets, and resolved Demand Gen creative references. Depending on the tool, responses can include public image URLs, video identifiers, thumbnails, dimensions, file types, and performance context.

## Setup and configuration

Install the documented source release with Node.js 22.12 or newer, then install dependencies and build the project. Configure an MCP client to run the resulting `dist/cli.js`, or use the npm package through `npx` as shown in the repository examples.

Required environment variables are `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CLIENT_ID`, `GOOGLE_ADS_CLIENT_SECRET`, and `GOOGLE_ADS_REFRESH_TOKEN`. A developer token comes from a manager account and may require Google review for live-account access. The OAuth client must belong to a Google Cloud project with the Google Ads API enabled. A refresh token is also required.

Set `GOOGLE_ADS_LOGIN_CUSTOMER_ID` when querying accounts managed through an MCC. The value may include dashes. Run the health-check tool first to confirm credential validity and account access.

## Tools and capabilities

The Google Ads MCP server supports:

- Account discovery, account details, hierarchy, and connectivity checks.
- Campaign, ad group, budget, bidding, conversion, recommendation, and change-event reads.
- GAQL execution, query validation, and structured performance reporting.
- Keyword ideas, historical metrics, and forecast metrics through Keyword Planner.
- Shopping, Search, landing-page, Performance Max, Demand Gen, and paid-organic reports.
- Image, video, and creative asset discovery with resolved media references.
- Preview-first campaign writes when explicitly enabled.

## Limitations and notes

Google reviews developer-token applications, so live-account setup may take time. A manager account requires the correct login customer ID or successful manager discovery. The standalone repository provides native API tools; hosted product interfaces and creative galleries described in the project materials are separate. Review current tool schemas before reusing saved arguments, especially after upgrades.

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