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