Google Ads
Full Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http google-ads 'https://api.mcp.ai/p_google_ads'
{
"mcpServers": {
"google-ads": {
"type": "http",
"url": "https://api.mcp.ai/p_google_ads"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Google Ads
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):
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
| Tool | Descrição |
|---|---|
google_ads_list_accounts | List all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC). |
google_ads_status | Without account: overview of all Google Ads MCCs and customer_ids. |
google_ads_account | Get Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope). |
google_ads_campaigns | List Google Ads campaigns with status and budgets. |
google_ads_today | Today Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary. |
google_ads_roas | ROAS for a date range (defaults to current month). |
google_ads_ads | List 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_keywords | Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. |
google_ads_keywords_search_terms | Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. |
google_ads_keywords_status | Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. |
google_ads_keywords_diagnostics | Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. |
google_ads_keywords_raw | Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. |
google_ads_performance | Daily performance breakdown: cost, impressions, clicks, conversions, revenue per day. |
google_ads_changes | Change history / audit log: who changed what in the account and when. |
google_ads_campaign_update_status | Pause, enable or remove one or more Google Ads campaigns. |
google_ads_campaign_update_budget | Update the daily budget of a campaign. |
google_ads_ad_group_update_status | Pause, enable or remove ad groups. |
google_ads_ad_update_status | Pause, 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_status | Pause, enable or remove keywords. |
google_ads_keyword_update_bid | Update max CPC for one or more keywords. |
google_ads_campaign_budget_create | Create 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_create | Create 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_create | Create an ad group inside a campaign. |
google_ads_keyword_add | Add positive keywords to an ad group. |
google_ads_negative_keyword_add | Add negative keywords at campaign or ad group scope. |
google_ads_responsive_search_ad_create | Create a Responsive Search Ad (RSA) inside an ad group. |
google_ads_sitelinks | List 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_create | Create sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group. |
google_ads_sitelink_remove | Detach 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.
Frequently asked questions
What is Google Ads?
Full Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p
How do I install Google Ads?
It runs as a remote server. In Claude Code: claude mcp add --transport http google-ads 'https://api.mcp.ai/p_google_ads'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Google Ads need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Google Ads open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Google Ads?
It is published by mcp-dir. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.