Google Ads MCP

Install

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

npx agentmarket install connector/scalably-io-google-ads-mcp

About

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

11 read · 0 write · 0 deleteRead-only

Secrets

3 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (11)

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_change_eventsAudit trail of changesread-only

  Audit trail: who changed what in the last 30 days. Max window is 30 days back. Returns: change_date_time, user_email, change_resource_type (CAMPAIGN|AD_GROUP|AD_GROUP_CRITERION|CAMPAIGN_BUDGET| AD|AD_GROUP_BID_MODIFIER|…), old_resource, new_resource, changed_fields, client_type (GOOGLE_ADS_WEB_CLIENT|GOOGLE_ADS_API|…). Args: customer_id: 10-digit customer_id. days_back: 1–30. resource_types: optional filter to specific change_resource_type enum values. limit: max rows (default 10000, capped 100000).

• google_ads_change_statusLightweight change status trackerread-only

  Lightweight change tracker: last-modified-at timestamps for resources. Unlike change_event, this is a per-resource "last modified" view rather than a change-diff log. Covers up to 14 days. Args: customer_id: 10-digit customer_id. days_back: 1–14. resource_types: optional filter by change_status.resource_type enum. limit: max rows.

• google_ads_describe_resourceDescribe GAQL resource schemaread-only

  Schema (fields, metrics, segments) for a GAQL resource. Queries GoogleAdsFieldService for every selectable field on a resource plus its data type, selectability, filterability, sort-ability, and `selectable_with` (which other fields can coexist in a single SELECT). Args: resource_name: the GAQL resource, e.g. "campaign", "ad_group", "shopping_performance_view", "change_event", "recommendation". Returns: {resource, fields: [{name, category: ATTRIBUTE|METRIC|SEGMENT, data_type, selectable, filterable, sortable, enum_values, type_url, selectable_with}]}. Essential before composing GAQL …

• google_ads_keyword_forecast_metricsForecast keyword plan KPIsread-only

  Forecast KPIs (impressions, clicks, cost, conversions) for a proposed keyword plan. Args: customer_id: 10-digit customer_id. campaign_spec: a KeywordPlanCampaign forecast spec. Minimum shape: { "bidding_strategy": "MANUAL_CPC", "daily_budget_micros": 10000000, "keyword_match_type": "BROAD" | "PHRASE" | "EXACT", "language_id": "1000", "geo_target_ids": ["2840"], "keywords": ["running shoes", "trail running shoes"] } Returns: {campaign_forecast: {impressions, clicks, cost_micros, conversions, average_cpc_micros}, weekly_time_series: [...]}. Rate…

• google_ads_keyword_historical_metricsHistorical keyword search metricsread-only

  Historical monthly search-volume + competition metrics for specific keywords. Args: customer_id: 10-digit customer_id. keywords: list of keyword strings (max 10,000 per call). language_id / geo_target_ids / keyword_network: same shape as keyword_ideas. year_month_start / year_month_end: optional date range as {year: 2025, month: 1..12}. Defaults to last 12 months. Returns: {results: [{text, approximate_monthly_searches, monthly_search_volumes: [{year, month, monthly_searches}], competition, high/low_top_of_page_bid_micros}]}. Rate limit: 1 QPS. May require Basic Access.

• google_ads_keyword_ideasGenerate keyword ideasread-only

  Generate keyword ideas with search volume + competition + CPC estimates. Args: customer_id: customer_id to attribute the request (any Ads account under MCC works). keywords: seed keywords, list of strings. Optional if page_url is given. page_url: seed URL (crawled for keyword extraction). Optional if keywords given. language_id: Google language criterion ID. Default '1000' (English). Common: '1001' Spanish, '1002' French, '1003' German, '1007' Italian. geo_target_ids: list of geo criterion IDs. Default ['2840'] (US). Common: '2826' UK, '2124' Canada, '2036' Australia, '2276'…

• google_ads_list_accessible_customersList accessible customersread-only

  List every customer_id the OAuth user has direct access to. This is a small, cheap list, typically just the MCC itself and any standalone accounts. For the full tree of accounts under the MCC (agency use case), call google_ads_list_customer_clients instead. Returns: {"resource_names": [...], "customer_ids": [...]}. Each customer_id is 10 digits, no hyphens.

• google_ads_list_customer_clientsList MCC customer clientsread-only

  Walk the MCC (Manager Account) hierarchy and return every child account. For agency use: this is the canonical "which clients can I query?" call. Uses GAQL on the `customer_client` resource. Fast: one streaming call. Args: mcc_customer_id: MCC customer_id. Defaults to GOOGLE_ADS_LOGIN_CUSTOMER_ID (the configured MCC). Accepts 10-digit or hyphenated. include_managers: include sub-MCCs in the result (default True). include_hidden: include customer_clients marked hidden=True (default False). max_level: max hierarchy depth (default 3, hard cap 10). Returns per account: customer_id, …

• google_ads_list_resourcesList GAQL resource catalogread-only

  Return the full catalog of GAQL resources (FROM-able tables). Useful when the agent needs to pick the right resource for a question. Each entry: name, category, selectable (whether it can be the FROM target). Response is cacheable for the session; the catalog is stable across queries.

• google_ads_queryRun a GAQL queryread-only

  Run a GAQL (Google Ads Query Language) query against a specific customer account. GAQL is SQL-like: `SELECT ... FROM <single_resource> WHERE ... ORDER BY ... LIMIT ...`. No JOINs; attribute fields from related resources by selecting them directly. Common resources: campaign, ad_group, keyword_view, search_term_view, shopping_performance_view, customer, customer_client, conversion_action, change_event, change_status, recommendation, asset, asset_group. Use google_ads_describe_resource first if unsure of field names on a new resource; saves a FIELD_NOT_FOUND roundtrip. Args: customer_id: 10…

• google_ads_recommendationsRead optimization recommendationsread-only

  Read Google's optimization recommendations for a customer account. Returns suggestions only; does NOT apply any. Types include: KEYWORD, CAMPAIGN_BUDGET, KEYWORD_MATCH_TYPE, TARGET_CPA_OPT_IN, MAXIMIZE_CLICKS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, ENHANCED_CPC_OPT_IN, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, CALL_EXTENSION, CALLOUT_EXTENSION, STRUCTURED_SNIPPET_EXTENSION, DISPLAY_EXPANSION_OPT_IN, KEYWORD_MATCH_TYPE, FORECASTING_*, SHOPPING_*, MOVE_UNUSED_BUDGET. (Google adds new types over time.) Args: customer_id: 10-digit account ID. types: optional list to filter by r…

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

36

Last commit

Sep 9, 2026 (1 month ago)

Last release

Sep 9, 2026 (1 month ago)

Last package publish

Sep 9, 2026 (1 month ago)

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

Details

Registry name

io.scalably/google-ads-mcp

Version

1.0.1

Auth

API key

Packages

pypi scalably-google-ads-mcpmcpb https://github.com/scalably-io/google-ads-mcp/releases/download/v1.0.1/google-ads-mcp.mcpb

License

MIT

Repository

github.com/scalably-io/google-ads-mcp

Website

scalably.io/mcp/google-ads-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql