Google Ads MCP Server

Servidor MCP completo para la gestión de Google Ads con CRUD total, panel de visualización, informes y gestión de todas las funcionalidades disponibles en el panel de Google Ads.

Funcionalidades (85+ herramientas)

Cuentas & Clientes

• list_accessible_customers — Listar cuentas accesibles

• get_customer_details — Detalles de la cuenta

• list_customer_clients — Clientes bajo MCC

• update_customer — Actualizar configuraciones

• get_account_hierarchy — Jerarquía de cuentas

• get_change_history — Historial de cambios

Campañas (CRUD Completo)

• list_campaigns — Listar campañas con filtros

• get_campaign — Detalles completos de la campaña

• create_campaign — Crear campaña (Search, Display, Shopping, Video, Performance Max, etc.)

• update_campaign — Actualizar nombre, estado, pujas, fechas

• remove_campaign — Eliminar campaña

• get_campaign_performance — Métricas de rendimiento

• copy_campaign — Copiar configuraciones de campaña

Grupos de Anuncios (CRUD Completo)

• list_ad_groups — Listar grupos de anuncios

• get_ad_group — Detalles del grupo

• create_ad_group — Crear grupo de anuncios

• update_ad_group — Actualizar configuraciones

• remove_ad_group — Eliminar grupo

• get_ad_group_performance — Métricas de rendimiento

Anuncios (CRUD Completo)

• list_ads — Listar anuncios

• get_ad — Detalles del anuncio

• create_responsive_search_ad — Crear RSA con titulares y descripciones

• update_ad_status — Activar/pausar anuncio

• remove_ad — Eliminar anuncio

• get_ad_performance — Métricas de rendimiento

Palabras clave (CRUD Completo)

• list_keywords — Listar palabras clave con puntuación de calidad

• add_keywords — Añadir palabras clave (Exacta, Frase, Amplia)

• update_keyword — Actualizar puja, estado, URL

• remove_keyword — Eliminar palabra clave

• get_keyword_performance — Rendimiento con porcentaje de impresiones

• get_search_terms — Informe de términos de búsqueda

• add_negative_keywords — Añadir negativas (campaña o grupo)

Presupuestos y Estrategias de Pujas

• list_budgets — Listar presupuestos

• create_budget — Crear presupuesto

• update_budget — Actualizar valor/método de entrega

• remove_budget — Eliminar presupuesto

• list_bidding_strategies — Listar estrategias

• create_bidding_strategy — Crear estrategia (Target CPA, Target ROAS, etc.)

• update_bidding_strategy — Actualizar estrategia

• remove_bidding_strategy — Eliminar estrategia

Audiencias y Segmentación

• list_audiences — Listar audiencias/listas de usuarios

• get_audience_performance — Rendimiento de audiencias

• list_campaign_targeting — Criterios de segmentación

• add_campaign_location_targeting — Segmentación geográfica

• add_campaign_language_targeting — Segmentación por idioma

• add_ad_schedule — Programación de anuncios (dayparting)

• remove_campaign_criterion — Eliminar criterio

• get_geo_target_constants — Buscar constantes geográficas

• get_demographics_performance — Rendimiento demográfico

Assets y Extensiones

• list_assets — Listar todos los activos

• create_sitelink_asset — Crear sitelink

• create_callout_asset — Crear callout

• create_structured_snippet_asset — Crear snippets estructurados

• create_call_asset — Crear extensión de llamada

• create_price_asset — Crear extensión de precio

• create_promotion_asset — Crear extensión de promoción

• create_lead_form_asset — Crear formulario de lead

• link_asset_to_campaign — Vincular activo a la campaña

• link_asset_to_ad_group — Vincular activo al grupo

• remove_asset — Eliminar activo

• get_asset_performance — Rendimiento de activos

• list_campaign_assets — Activos de una campaña

• remove_campaign_asset — Desvincular activo

Conversiones

• list_conversion_actions — Listar acciones de conversión

• get_conversion_action — Detalles de la conversión

• create_conversion_action — Crear acción de conversión

• update_conversion_action — Actualizar conversión

• remove_conversion_action — Eliminar conversión

• get_conversion_performance — Rendimiento de conversiones

Informes y Panel

• execute_gaql_query — Ejecutar consulta GAQL personalizada

• get_account_dashboard — Panel completo de la cuenta

• get_campaign_dashboard — Panel detallado de campaña

• get_performance_by_device — Rendimiento por dispositivo

• get_performance_by_network — Rendimiento por red

• get_performance_by_hour — Rendimiento por hora

• get_performance_by_day_of_week — Rendimiento por día de la semana

• get_geographic_performance — Rendimiento geográfico

• get_landing_page_performance — Rendimiento de páginas de destino

• compare_date_ranges — Comparar períodos

Etiquetas y Conjuntos Compartidos

• list_labels — Listar etiquetas

• create_label — Crear etiqueta

• remove_label — Eliminar etiqueta

• apply_label_to_campaign — Aplicar etiqueta a la campaña

• apply_label_to_ad_group — Aplicar etiqueta al grupo

• list_shared_sets — Listar listas compartidas

• create_shared_set — Crear lista de negativas compartida

• add_shared_set_criteria — Añadir términos a la lista

• link_shared_set_to_campaign — Vincular lista a la campaña

Recomendaciones y Optimización

• list_recommendations — Listar recomendaciones de Google

• apply_recommendation — Aplicar recomendación

• dismiss_recommendation — Descartar recomendación

• get_optimization_score — Puntuación de optimización

Experimentos y Cambios

• list_experiments — Listar pruebas A/B

• list_experiment_arms — Listar variantes

• get_change_status — Cambios recientes

Requisitos previos

1. Google Cloud Project con la API de Google Ads habilitada

2. OAuth2 Client ID tipo Desktop

3. Developer Token de Google Ads (obtenido en ads.google.com > API Center)

4. Node.js >= 18

Instalación

npm install
npm run build

Configuración

Opción 1: Variables de entorno

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

Opción 2: Configuración interactiva

npm run auth

Esto creará un archivo de credenciales en ~/.google-ads-mcp/credentials.json.

Configuración en Claude Code

Añada a su ~/.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

Después de configurar, todas las herramientas están disponibles vía MCP. Ejemplos:

• "Lista todas mis campañas activas"

• "Crea una campaña de Search con presupuesto de R$50/día"

• "Muestra el panel de rendimiento de los últimos 30 días"

• "Añade estas palabras clave al grupo de anuncios X: ..."

• "Pausa la campaña Y"

• "Muestra el informe de términos de búsqueda"

• "¿Cuáles son las recomendaciones de Google para mi cuenta?"

Versión de la API

Este servidor usa la Google Ads API v23 (la más reciente, lanzada en enero de 2026).

Estructura del Proyecto

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