de en es ja ko ru zh

google-ads-mcp

Name: google-ads-mcp
Author: ZLeventer

by ZLeventer

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

google-ads-mcp

npm version npm downloads glama score Node.js MCP License: MIT

MCP-сервер для Google Ads — диагностика эффективности расходов, доли показов и эффективности активов из Claude.

22 инструмента для работы с кампаниями, ключевыми словами, RSA, активами, аудиториями, сегментацией по гео/устройствам, долей показов, аукционной статистикой и планированием бюджета — плюс возможность выполнения произвольных запросов GAQL. Создан для команд контекстной рекламы в B2B и агентств, которым нужна реальная диагностика, а не просто дашборды в стиле «покажи мои кампании».

Зачем это нужно

Большинство MCP-серверов для Google Ads ограничиваются функционалом «список кампаний + базовые метрики». Этот сервер решает задачи, которые действительно волнуют специалистов по контекстной рекламе: какие активы RSA помечены как LOW, чтобы я мог их заменить, какие ключевые слова расходуют бюджет без конверсий, кому я проигрываю по доле показов согласно аукционной статистике, какова разница в CPA между мобильными устройствами и десктопом, какие кампании сейчас ограничены бюджетом. Это те рычаги, которые позволяют улучшить эффективность — и все они являются здесь инструментами первого класса.

Отличие от официального googleads/google-ads-mcp: предоставляет метки эффективности активов RSA, аукционную статистику, анализ доли показов, сегментацию по гео/устройствам, проверку таргетинга на аудитории и планирование бюджета.

Related MCP server: adops-mcp

Примеры запросов

После установки вы можете спрашивать Claude о следующем:

«Какова моя доля показов по сравнению с конкурентами в этом месяце? Кому я чаще всего проигрываю?»
«Покажи все активы RSA с меткой эффективности LOW, чтобы я мог их заменить.»
«Какие ключевые слова тратят больше всего при нулевых конверсиях за последние 30 дней?»
«Какова разница в CPA между мобильными устройствами и десктопом по всем кампаниям?»
«Есть ли сейчас кампании, ограниченные бюджетом? Покажи Lost IS (Budget).»
«Перечисли мои ремаркетинговые аудитории и скажи, какие из них достаточно велики для таргетинга в поиске.»

Демо

🎥 Видео с обзором скоро появится — диагностика неэффективных расходов из Claude менее чем за 60 секунд.

Возможности

Категория	Инструменты
Аккаунт	Список аккаунтов, информация об аккаунте
Кампании	Список кампаний, эффективность кампаний, эффективность групп объявлений
Ключевые слова	Эффективность ключевых слов, отчет по поисковым запросам
Конверсии	Конверсии по кампаниям, список действий-конверсий
Тексты объявлений / RSA	Список RSA с оценкой эффективности, метки эффективности активов RSA
Активы / Расширения	Список активов аккаунта, активы кампаний
Аудитории	Список списков пользователей, таргетинг кампаний на аудитории
Эффективность	Эффективность по гео, эффективность по устройствам, доля показов, аукционная статистика
Бюджет	Список бюджетов, планирование бюджета
Произвольный запрос	Выполнение GAQL-запроса

Предварительные требования

Node.js 20+
Токен разработчика Google Ads (получить здесь)
Учетные данные OAuth 2.0 (Client ID + Secret) из Google Cloud Console
Токен обновления (refresh token) с областью доступа https://www.googleapis.com/auth/adwords

Переменные окружения

Переменная	Обязательно	Описание
`GOOGLE_ADS_DEVELOPER_TOKEN`	Да	Ваш токен разработчика Google Ads
`GOOGLE_ADS_CLIENT_ID`	Да	OAuth 2.0 client ID
`GOOGLE_ADS_CLIENT_SECRET`	Да	OAuth 2.0 client secret
`GOOGLE_ADS_REFRESH_TOKEN`	Да	OAuth 2.0 refresh token
`GOOGLE_ADS_CUSTOMER_ID`	Да*	ID клиента по умолчанию (без дефисов). Можно переопределить при вызове инструмента.
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`	Нет	ID управляющего аккаунта (MCC) для доступа

Использование

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "google-ads-mcp"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/path/to/google-ads-mcp/dist/index.js"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Cursor (`~/.cursor/mcp.json`)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "google-ads-mcp"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Docker

docker build -t google-ads-mcp .
docker run --rm \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_TOKEN \
  -e GOOGLE_ADS_CLIENT_ID=YOUR_CLIENT_ID \
  -e GOOGLE_ADS_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \
  -e GOOGLE_ADS_CUSTOMER_ID=1234567890 \
  google-ads-mcp

Справочник инструментов

Инструмент	Описание
`gads_run_gaql`	Выполнение любого произвольного GAQL-запроса — для пользовательских отчетов
`gads_list_accounts`	Список всех доступных аккаунтов Google Ads
`gads_account_info`	Название, валюта, часовой пояс, флаг управляющего аккаунта, статус
`gads_list_campaigns`	Кампании со статусом, типом канала и стратегией назначения ставок
`gads_campaign_performance`	Показы, клики, CTR, CPC, стоимость, конверсии, CPA, ROAS
`gads_ad_group_performance`	Метрики групп объявлений в контексте кампаний
`gads_keyword_performance`	Ключевые слова с типом соответствия, показателем качества, стоимостью, конверсиями
`gads_search_terms_report`	Фактические поисковые запросы пользователей — для поиска минус-слов и возможностей
`gads_conversions_by_campaign`	Конверсии × действие-конверсия по каждой кампании
`gads_list_conversion_actions`	Все действия-конверсии с категорией, типом и методом подсчета
`gads_list_rsas`	RSA со всеми заголовками, описаниями, оценкой эффективности и статусом одобрения
`gads_rsa_asset_performance`	Метки эффективности для каждого актива: BEST / GOOD / LOW / PENDING / LEARNING
`gads_list_assets`	Активы аккаунта: доп. ссылки, уточнения, структурированные описания, изображения
`gads_campaign_assets`	Активы, привязанные к кампаниям, с указанием типа поля
`gads_list_audiences`	Списки пользователей (ремаркетинг, customer match) с размером и уровнем совпадения
`gads_campaign_audience_targeting`	Аудитории в кампаниях с корректировками ставок и включением/исключением
`gads_geo_performance`	Эффективность по странам, регионам и городам
`gads_device_performance`	Стоимость, конверсии, CPA с разбивкой по MOBILE / DESKTOP / TABLET
`gads_impression_share`	Доля показов в поиске, потерянная доля показов (бюджет), потерянная доля показов (рейтинг) по кампаниям
`gads_auction_insights`	Доля показов, коэффициент пересечения, доля выигрышей по сравнению с конкурентами
`gads_list_budgets`	Все бюджеты: сумма, метод доставки, период, рекомендованный бюджет
`gads_budget_pacing`	Стоимость по сравнению с бюджетом по кампаниям с процентом использования

Сборка из исходного кода

git clone https://github.com/ZLeventer/google-ads-mcp.git
cd google-ads-mcp
npm install
npm run build

Лицензия

Available Tools

22 tools

gads_account_infoA

Get basic info for the current Google Ads account: name, currency, timezone, manager flag, status.

Inputs: customer_id.

gads_ad_group_performanceB

Ad group performance with campaign context. Optional campaign_id filter. Default last 28 days, enabled ad groups.

Inputs: start_date, end_date, customer_id, limit, +2 more.

gads_auction_insightsB

Auction Insights report: impression share, overlap rate, outranking share, top-of-page %, and absolute top % vs competitors. Optional campaign filter.

Inputs: customer_id, start_date, end_date, campaign_id.

gads_budget_pacingA

Cost vs budget per campaign for the specified period with utilization percentage. Flags over- and under-pacing campaigns. Default last 28 days.

Inputs: customer_id, start_date, end_date.

gads_campaign_assetsA

Assets linked to campaigns with field type and status. Shows which extensions are active on which campaigns.

Inputs: customer_id, campaign_id.

gads_campaign_audience_targetingA

Audiences attached to campaigns with targeting setting (observation vs targeting) and bid modifier. Shows both inclusion and exclusion lists.

Inputs: customer_id, campaign_id.

gads_campaign_performanceA

Campaign-level performance: impressions, clicks, CTR, avg CPC, cost, conversions, conv value, CPA, ROAS. Defaults to last 28 days, enabled campaigns, sorted by cost desc.

Inputs: start_date, end_date, customer_id, limit, +2 more.

gads_conversions_by_campaignB

Conversions and conversion value broken down by campaign × conversion action. Sorted by conversions desc. Default last 28 days.

Inputs: start_date, end_date, customer_id, limit.

gads_device_performanceA

Clicks, cost, CTR, conversions, and CPA split by MOBILE / DESKTOP / TABLET per campaign. Default last 28 days.

Inputs: customer_id, start_date, end_date, campaign_id.

gads_geo_performanceB

Performance broken down by geographic location (country, region, city). Surfaces top and bottom geo segments by cost and conversions.

Inputs: customer_id, start_date, end_date, campaign_id, +1 more.

gads_impression_shareA

Search Impression Share, Lost IS (Budget), and Lost IS (Rank) per campaign. Identifies whether budget or Quality Score/bid is limiting reach.

Inputs: customer_id, start_date, end_date.

gads_keyword_performanceA

Keyword-level performance with match type, quality score, clicks, cost, conversions. Filter by campaign_id or ad_group_id. Default last 28 days, enabled keywords.

Inputs: start_date, end_date, customer_id, limit, +3 more.

gads_list_accountsA

List all Google Ads customer accounts the authenticated user has access to. Useful for finding customer IDs.

Inputs: no named parameters.

gads_list_assetsB

List account-level assets: sitelinks, callouts, structured snippets, images, call extensions, and more. Filter by asset type.

Inputs: customer_id, asset_type, limit.

gads_list_audiencesB

List user lists (remarketing audiences, customer match lists) in the account with size, eligibility, and match rate.

Inputs: customer_id, limit.

gads_list_budgetsB

All campaign budgets with daily/total amount, delivery method (STANDARD/ACCELERATED), period, and whether a recommended budget exists.

Inputs: customer_id.

gads_list_campaignsB

List campaigns in the account with name, status, channel type, bidding strategy, and date range. Filter by status (default ENABLED).

Inputs: status, customer_id, limit.

gads_list_conversion_actionsC

List all conversion actions configured in the account: name, category, type, whether included in Conversions metric, counting type.

Inputs: customer_id, status.

gads_list_rsasB

List Responsive Search Ads with all headlines, descriptions, Ad Strength rating, and approval status. Filter by campaign or ad group.

Inputs: customer_id, campaign_id, ad_group_id, limit.

gads_rsa_asset_performanceA

Asset-level performance labels (BEST / GOOD / LOW / PENDING / LEARNING) for RSA headlines and descriptions. Identifies which assets to keep, test, or replace.

Inputs: customer_id, ad_group_id, date_range.

gads_run_gaqlA

Escape hatch: run any raw GAQL query against Google Ads. Use when preset tools don't cover the report shape you need. Docs: developers.google.com/google-ads/api/docs/query/overview

Inputs: query (required), customer_id.

gads_search_terms_reportA

Search terms that triggered ads (the actual user queries, not your keywords). Essential for finding wasted spend and negative keyword candidates. Default last 28 days.

Inputs: start_date, end_date, customer_id, limit, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-04-28 20:20 across 22 tools

Disambiguation5/5

Each tool targets a distinct aspect of Google Ads (account info, campaign performance, keyword performance, asset management, etc.). Even related tools like campaign_performance and ad_group_performance are clearly differentiated by level. No two tools appear to serve the same purpose.

Naming Consistency4/5

All tools share the 'gads_' prefix and use lowercase with underscores. The naming follows a descriptive phrase pattern (e.g., gads_campaign_performance, gads_rsa_asset_performance). While not strictly verb_noun, the convention is consistent and readable.

Tool Count5/5

22 tools is well-scoped for a comprehensive Google Ads server. It covers listing entities, performance reports across dimensions, conversion analysis, budget pacing, auction insights, and an escape hatch. Each tool earns its place without overwhelming the user.

Completeness4/5

The tool set covers most common reporting and listing needs (campaigns, ad groups, keywords, assets, audiences, conversions, etc.). Missing write operations (create/update/delete) but these are often out of scope for a reporting-focused MCP server. The GAQL escape hatch compensates for any missing report shapes.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Google Ads MCP by AdPlug
io.github.danielpopamd
Google Ads MCP server: 17 tools for reporting, campaigns, keywords, assets. Writes preview first.
Marketing
1
https://api.adplug.app/mcp/google-ads
google-ads
ai.adramp
Google Ads MCP server — manage campaigns, keywords, and metrics.
Marketing E-commerce & Retail
2
https://mcp.adramp.ai
Microsoft Ads MCP by AdPlug
io.github.danielpopamd
Microsoft Ads MCP server: 11 tools for search, PMax, Google Ads imports. Read-only by default.
Marketing
1
https://api.adplug.app/mcp/microsoft-ads
Honeyfield Marketing MCPB
at.honeyfield
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
Data Platforms Marketing Social Media
3481
https://mcp.ads.honeyfield.at/mcp

Related MCP Servers

PaidSync (Ads analysis &official
Marketing Finance
traffiy
A
license
Not graded
quality
F
maintenance
MCP server for managing Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads via AI. 210+ tools including account audits, wasted spend detection, and PMax insights.
Updated 6 months ago (2026-05-11 08:14 UTC)
2
MIT
adops-mcp
Marketing AI & Machine Learning Monitoring
automatiabcn
A
license
A
quality
C
maintenance
Cross-platform ad management MCP server for Google Ads and Meta Ads. Campaign analytics, A/B testing with z-test, anomaly detection, and budget reallocation. 15 tools, 60 tests.
Updated 2 months ago (2026-09-13 14:41 UTC)
17
92 npm
MIT
Google Ads MCP Server
bertramdev
A
license
Not graded
quality
D
maintenance
A comprehensive Google Ads MCP server providing ~47 tools for full read/write access to Google Ads accounts, including campaign management, ad creation, keyword management, and reporting.
Updated 8 months ago (2026-03-23 19:27 UTC)
2
Apache 2.0
Google Ads Campaign MCP
Marketing Search
clientskatbi
A
license
Not graded
quality
D
maintenance
MCP server for managing Google Ads campaigns through the official Google Ads API, covering accounts, campaigns, budgets, keywords, search terms, and keyword ideas. It provides tools for both reading and mutating live ads data, such as pausing campaigns, updating budgets, and adding keywords.
Updated 3 months ago (2026-08-09 07:12 UTC)
MIT

google-ads-mcp

Зачем это нужно

Примеры запросов

Демо

Возможности

Предварительные требования

Переменные окружения

Использование

Claude Desktop (claude_desktop_config.json)

Claude Code

Cursor (~/.cursor/mcp.json)

Docker

Справочник инструментов

Сборка из исходного кода

Лицензия

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

PaidSync (Ads analysis &official

adops-mcp

Google Ads MCP Server

Google Ads Campaign MCP

Claude Desktop (`claude_desktop_config.json`)

Cursor (`~/.cursor/mcp.json`)