Google Ads

MCP serverSearch

This integration connects your AI to Google Ads so it can manage your advertising account for you. Once added, your AI can review campaign performance, check return on ad spend, and make changes to campaigns and keywords on your behalf.

Then ask your AI: use the google ads list accounts tool from Google Ads

Details

Available today. Use it as a step in a pipeline you build, or from your connected AI.

After adding it, connect your Google Ads account and ask your AI to pull up your latest campaign performance. From there you can request changes in plain language.

What your AI can do with it

  • Review campaign performance and return on ad spend
  • Look up keywords and the search terms people actually used
  • Read campaign settings and account data
  • Make changes to campaigns and keywords
  • Adjust advertising settings directly from a conversation

Install Google Ads

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user google-ads 'https://api.mcp.ai/p_google_ads'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://api.mcp.ai/p_google_ads

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=google-ads&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9nb29nbGVfYWRzIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://api.mcp.ai/p_google_ads

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add google-ads --url 'https://api.mcp.ai/p_google_ads'

    Run it once, then sign in with codex mcp login google-ads if the server asks for an account.

From the project's README

As published by mcp-dir/google_ads-mcp in README.md.

Google Ads para Claude, ChatGPT e agentes de IA

Gestão completa de Google Ads: leitura (campanhas, performance, ROAS, keywords, termos de busca) e escrita (pausar/ativar/remover campanhas, ad groups, ads e keywords, ajustar orçamento e lance, criar budget, campanha, ad group, keywords positivas/negativas e RSAs). Você fornece developer token, OAuth client_id/secret, refresh_token e MCC, sem etapa OAuth no servidor.

  • 📊 29 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes


Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Google Ads e URL https://api.mcp.ai/p_google_ads.

Cursor

➕ Instalar Google Ads no Cursor

VS Code (Copilot Chat)

➕ Instalar Google Ads no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_google_ads

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Liste minhas contas Google Ads acessíveis pela MCC
Quanto gastei hoje em Google Ads e qual o ROAS por campanha?
Top 10 palavras-chave por custo nos últimos 7 dias

29 ferramentas disponíveis

ToolDescrição
google_ads_list_accountsList all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC).
google_ads_statusWithout account: overview of all Google Ads MCCs and customer_ids.
google_ads_accountGet Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope).
google_ads_campaignsList Google Ads campaigns with status and budgets.
google_ads_todayToday Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary.
google_ads_roasROAS for a date range (defaults to current month).
google_ads_adsList enabled ads with type, status, campaign name and ad_group_ad.policy_summary (approval_status, review_status, policy_topic_entries) — answers "why is my ad not serving?" without opening the Google Ads UI.
google_ads_keywords_keywordsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_search_termsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_statusKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_diagnosticsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_rawKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_performanceDaily performance breakdown: cost, impressions, clicks, conversions, revenue per day.
google_ads_changesChange history / audit log: who changed what in the account and when.
google_ads_campaign_update_statusPause, enable or remove one or more Google Ads campaigns.
google_ads_campaign_update_budgetUpdate the daily budget of a campaign.
google_ads_ad_group_update_statusPause, enable or remove ad groups.
google_ads_ad_update_statusPause, enable or remove ads. Each entry needs ad_group_id + ad_id because the ad resource is keyed by both (customers/X/adGroupAds/{ad_group_id}~{ad_id}). Bulk support: accepts customer_ids for batched execution.
google_ads_keyword_update_statusPause, enable or remove keywords.
google_ads_keyword_update_bidUpdate max CPC for one or more keywords.
google_ads_campaign_budget_createCreate a campaign_budget. Required to create a campaign. Amount is daily, in account currency unit (50 = R$50/day). Bulk support: accepts customer_ids for batched execution.
google_ads_campaign_createCreate a Google Ads campaign. Defaults to channel_type=SEARCH, status=PAUSED (safe), bidding_strategy=MANUAL_CPC. Provide budget_id from google_ads_campaign_budget_create. Declares no EU political advertising by defau…
google_ads_ad_group_createCreate an ad group inside a campaign.
google_ads_keyword_addAdd positive keywords to an ad group.
google_ads_negative_keyword_addAdd negative keywords at campaign or ad group scope.
google_ads_responsive_search_ad_createCreate a Responsive Search Ad (RSA) inside an ad group.
google_ads_sitelinksList sitelink assets in the account and where they are attached (campaign / account / ad group level), with each link's resource_name (pass it to google_ads_sitelink_remove) and status.
google_ads_sitelink_createCreate sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group.
google_ads_sitelink_removeDetach sitelinks from a campaign / account / ad group.

Detalhe de cada tool: docs/ferramentas.md


Preços

Grátis.


Privacidade & LGPD

  • Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_google_ads.


Suporte


Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_google_ads é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Tools it offers (35)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • google_ads_list_accounts
  • google_ads_status
  • google_ads_account
  • google_ads_campaigns
  • google_ads_today
  • google_ads_roas
  • google_ads_ads
  • google_ads_keywords_keywords
  • google_ads_keywords_search_terms
  • google_ads_keywords_status
  • google_ads_keywords_diagnostics
  • google_ads_keywords_raw
  • google_ads_performance
  • google_ads_changes
  • google_ads_campaign_update_status
  • google_ads_campaign_update_budget
  • google_ads_ad_group_update_status
  • google_ads_ad_update_status
  • google_ads_keyword_update_status
  • google_ads_keyword_update_bid
  • google_ads_campaign_budget_create
  • google_ads_campaign_create
  • google_ads_ad_group_create
  • google_ads_keyword_add
  • google_ads_negative_keyword_add
  • google_ads_responsive_search_ad_create
  • google_ads_sitelinks
  • google_ads_sitelink_create
  • google_ads_sitelink_remove
  • show_version

Signals

Last commit
Aug 2026

Ahel review

  • S4info
    community integration, published by mcp-dir, not google

Automated review, not a security audit. Ruleset v1.

Advanced
Delivery
google_ads-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-mcp-dir-google-ads-mcp
Source
github.com/mcp-dir/google_ads-mcp
Hosted endpoint
https://api.mcp.ai/p_google_ads