Skip to main content
Glama
vertexdevs-hq

Google Ads MCP Server

by vertexdevs-hq
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Remote

Google Ads MCP Server

Servidor MCP completo para gerenciamento do Google Ads com CRUD total, dashboard de visualização, relatórios e gestão de todas as funcionalidades disponíveis no painel do Google Ads.

Funcionalidades (85+ ferramentas)

Contas & Clientes

  • list_accessible_customers — Listar contas acessíveis

  • get_customer_details — Detalhes da conta

  • list_customer_clients — Clientes sob MCC

  • update_customer — Atualizar configurações

  • get_account_hierarchy — Hierarquia de contas

  • get_change_history — Histórico de alterações

Campanhas (CRUD Completo)

  • list_campaigns — Listar campanhas com filtros

  • get_campaign — Detalhes completos da campanha

  • create_campaign — Criar campanha (Search, Display, Shopping, Video, Performance Max, etc.)

  • update_campaign — Atualizar nome, status, lances, datas

  • remove_campaign — Remover campanha

  • get_campaign_performance — Métricas de performance

  • copy_campaign — Copiar configurações de campanha

Grupos de Anúncios (CRUD Completo)

  • list_ad_groups — Listar grupos de anúncios

  • get_ad_group — Detalhes do grupo

  • create_ad_group — Criar grupo de anúncios

  • update_ad_group — Atualizar configurações

  • remove_ad_group — Remover grupo

  • get_ad_group_performance — Métricas de performance

Anúncios (CRUD Completo)

  • list_ads — Listar anúncios

  • get_ad — Detalhes do anúncio

  • create_responsive_search_ad — Criar RSA com headlines e descriptions

  • update_ad_status — Ativar/pausar anúncio

  • remove_ad — Remover anúncio

  • get_ad_performance — Métricas de performance

Palavras-chave (CRUD Completo)

  • list_keywords — Listar keywords com quality score

  • add_keywords — Adicionar keywords (Exact, Phrase, Broad)

  • update_keyword — Atualizar lance, status, URLs

  • remove_keyword — Remover keyword

  • get_keyword_performance — Performance com impression share

  • get_search_terms — Relatório de termos de pesquisa

  • add_negative_keywords — Adicionar negativos (campanha ou grupo)

Orçamentos & Estratégias de Lances

  • list_budgets — Listar orçamentos

  • create_budget — Criar orçamento

  • update_budget — Atualizar valor/método de entrega

  • remove_budget — Remover orçamento

  • list_bidding_strategies — Listar estratégias

  • create_bidding_strategy — Criar estratégia (Target CPA, Target ROAS, etc.)

  • update_bidding_strategy — Atualizar estratégia

  • remove_bidding_strategy — Remover estratégia

Audiências & Segmentação

  • list_audiences — Listar audiências/user lists

  • get_audience_performance — Performance de audiências

  • list_campaign_targeting — Critérios de segmentação

  • add_campaign_location_targeting — Segmentação geográfica

  • add_campaign_language_targeting — Segmentação por idioma

  • add_ad_schedule — Programação de anúncios (dayparting)

  • remove_campaign_criterion — Remover critério

  • get_geo_target_constants — Buscar constantes geográficas

  • get_demographics_performance — Performance demográfica

Assets & Extensões

  • list_assets — Listar todos os assets

  • create_sitelink_asset — Criar sitelink

  • create_callout_asset — Criar callout

  • create_structured_snippet_asset — Criar snippets estruturados

  • create_call_asset — Criar extensão de chamada

  • create_price_asset — Criar extensão de preço

  • create_promotion_asset — Criar extensão de promoção

  • create_lead_form_asset — Criar formulário de lead

  • link_asset_to_campaign — Vincular asset à campanha

  • link_asset_to_ad_group — Vincular asset ao grupo

  • remove_asset — Remover asset

  • get_asset_performance — Performance de assets

  • list_campaign_assets — Assets de uma campanha

  • remove_campaign_asset — Desvincular asset

Conversões

  • list_conversion_actions — Listar ações de conversão

  • get_conversion_action — Detalhes da conversão

  • create_conversion_action — Criar ação de conversão

  • update_conversion_action — Atualizar conversão

  • remove_conversion_action — Remover conversão

  • get_conversion_performance — Performance de conversões

Relatórios & Dashboard

  • execute_gaql_query — Executar consulta GAQL personalizada

  • get_account_dashboard — Dashboard completo da conta

  • get_campaign_dashboard — Dashboard detalhado de campanha

  • get_performance_by_device — Performance por dispositivo

  • get_performance_by_network — Performance por rede

  • get_performance_by_hour — Performance por hora

  • get_performance_by_day_of_week — Performance por dia da semana

  • get_geographic_performance — Performance geográfica

  • get_landing_page_performance — Performance de landing pages

  • compare_date_ranges — Comparar períodos

Labels & Conjuntos Compartilhados

  • list_labels — Listar labels

  • create_label — Criar label

  • remove_label — Remover label

  • apply_label_to_campaign — Aplicar label à campanha

  • apply_label_to_ad_group — Aplicar label ao grupo

  • list_shared_sets — Listar listas compartilhadas

  • create_shared_set — Criar lista de negativos compartilhada

  • add_shared_set_criteria — Adicionar termos à lista

  • link_shared_set_to_campaign — Vincular lista à campanha

Recomendações & Otimização

  • list_recommendations — Listar recomendações do Google

  • apply_recommendation — Aplicar recomendação

  • dismiss_recommendation — Ignorar recomendação

  • get_optimization_score — Score de otimização

Experimentos & Alterações

  • list_experiments — Listar testes A/B

  • list_experiment_arms — Listar variantes

  • get_change_status — Alterações recentes

Pré-requisitos

  1. Google Cloud Project com a Google Ads API habilitada

  2. OAuth2 Client ID tipo Desktop

  3. Developer Token do Google Ads (obtido em ads.google.com > API Center)

  4. Node.js >= 18

Instalação

npm install
npm run build

Configuração

Opção 1: Variáveis de ambiente

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

Opção 2: Setup interativo

npm run auth

Isso criará um arquivo de credenciais em ~/.google-ads-mcp/credentials.json.

Configuração no Claude Code

Adicione ao seu ~/.claude/settings.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Uso

Após configurar, todas as ferramentas ficam disponíveis via MCP. Exemplos:

  • "Liste todas as minhas campanhas ativas"

  • "Crie uma campanha de Search com orçamento de R$50/dia"

  • "Mostre o dashboard de performance dos últimos 30 dias"

  • "Adicione estas keywords ao grupo de anúncios X: ..."

  • "Pause a campanha Y"

  • "Mostre o relatório de termos de pesquisa"

  • "Quais são as recomendações do Google para minha conta?"

API Version

Este servidor usa a Google Ads API v23 (mais recente, lançada em Janeiro 2026).

Estrutura do Projeto

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions