Skip to main content
Glama
Google Tag Manager MCP Server

Google Tag Manager MCP Server

by ramedina-ia

🏷️ Google Tag Manager MCP Server (GTM)

License: MIT Protocol: MCP TypeScript Security: STDIO Hardened

Servidor oficial de Model Context Protocol (MCP) en TypeScript puro para la auditorΓ­a, automatizaciΓ³n y gestiΓ³n programΓ‘tica de Google Tag Manager (Web y Server-Side) mediante asistentes de Inteligencia Artificial como Google Antigravity, Claude Desktop y Cursor.

DiseΓ±ado bajo los mΓ‘s altos estΓ‘ndares de ciberseguridad empresarial, reemplazando arquitecturas vulnerables basadas en demonios de red o puertos locales por un transporte STDIO aislado, autenticaciΓ³n nativa OAuth 2.0 y guardrails de seguridad contra despliegues destructivos en producciΓ³n.


πŸ›‘οΈ ΒΏPor quΓ© este Servidor MCP? (AuditorΓ­a & Seguridad)

Muchos servidores MCP comunitarios para GTM presentan fallas crΓ­ticas de seguridad:

  • ❌ Puertos locales expuestos (http://localhost:9090): Abren la puerta a ataques de Server-Side Request Forgery (SSRF) y Cross-Process Snooping.

  • ❌ Tokens y claves estΓ‘ticas en texto plano: Expuestas en scripts .cmd o .ps1.

  • ❌ Despliegues sin control (Riesgo de Stored XSS): Permiten a una IA publicar cΓ³digo JavaScript directamente en producciΓ³n sin confirmaciΓ³n humana explΓ­cita (dual-custody).

  • ❌ Binarios monolΓ­ticos externos: DifΓ­ciles de auditar y mantener.

✨ Ventajas de nuestra solución:

  • βœ… Aislamiento Total por Proceso (STDIO): Cero puertos de red abiertos, cero riesgo de interceptaciΓ³n local.

  • βœ… Guardrail de ConfirmaciΓ³n en Publicaciones (confirmPublish): Impide publicaciones accidentales a trΓ‘fico en vivo.

  • βœ… GestiΓ³n CriptogrΓ‘fica de Credenciales: AutenticaciΓ³n segura mediante OAuth 2.0 Refresh Token renovado en memoria.

  • βœ… GestiΓ³n de Entornos de Trabajo Borrador: Todas las modificaciones se realizan de forma segura en borradores antes de generar versiones.

  • βœ… 100% TypeScript Nativo: CΓ³digo limpio, auditable y mantenible.


Related MCP server: Samarth GTM MCP Server

πŸ—οΈ Arquitectura TΓ©cnica

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚             Google Antigravity / Claude                β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β”‚ Protocolo MCP (STDIO puro)
                           β”‚ JSON-RPC 2.0 (stdin/stdout)
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚          google-tag-manager-mcp (TypeScript)           β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚   Auth Manager        β”‚    GTM Service Engine    β”‚  β”‚
β”‚  β”‚   (OAuth2 Refresh)    β”‚    (tagmanager v2)       β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚ Guardrails de Seguridad (confirmPublish: true)   β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β”‚ HTTPS TLS 1.3
                           β”‚ API Oficial de Google
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚           Google Tag Manager API (v2)                  β”‚
β”‚       Contenedores Web | Contenedores Server (S2S)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🧰 CatÑlogo de Herramientas (17 Tools)

1. InspecciΓ³n y Lectura (Read-Only)

Herramienta

DescripciΓ³n

gtm_list_accounts

Lista todas las cuentas de GTM asociadas a la credencial.

gtm_list_containers

Lista los contenedores Web y Server-Side de una cuenta.

gtm_get_container

Obtiene detalles y configuraciΓ³n tΓ©cnica de un contenedor.

gtm_list_workspaces

Lista los espacios de trabajo (workspaces) activos.

gtm_get_workspace_status

Inspecciona entidades modificadas/pendientes sin publicar.

gtm_list_tags

Lista todas las etiquetas con sus estados y activadores.

gtm_get_tag

Obtiene la configuraciΓ³n detallada de una etiqueta especΓ­fica.

gtm_list_triggers

Lista todos los activadores y condiciones de evento.

gtm_get_trigger

Consulta las reglas de filtrado de un activador.

gtm_list_variables

Lista las variables personalizadas (DataLayer, DOM, Constantes).

gtm_list_built_in_variables

Lista las variables integradas del sistema habilitadas.

2. Escritura Segura en Borradores (Draft Workspaces)

Herramienta

DescripciΓ³n

gtm_create_tag

Crea etiquetas (GA4, Google Ads, Meta Pixel, HTML Personalizado).

gtm_update_tag

Modifica parΓ‘metros, activadores o pausa una etiqueta existente.

gtm_create_trigger

Crea activadores (Eventos personalizados, Clics, PΓ‘ginas vistas).

gtm_create_variable

Crea variables personalizadas para captura de telemetrΓ­a.

3. Control de Versiones y Despliegue con Guardrail

Herramienta

DescripciΓ³n

gtm_create_version

Congela los cambios del workspace en una versiΓ³n snapshot con notas.

gtm_publish_version

Publica en vivo a producciΓ³n. Exige obligatoriamente confirmPublish: true.


πŸš€ InstalaciΓ³n y Puesta en Marcha

Prerrequisitos

  • Node.js 20 o superior.

  • Una cuenta de Google Cloud Console con la Tag Manager API habilitada.

  • Credenciales OAuth 2.0 (Client ID y Client Secret) y un Refresh Token de GTM.

1. Clonar el Repositorio

git clone https://github.com/ramedina-ia/google-tag-manager-mcp.git
cd google-tag-manager-mcp

2. Instalar Dependencias y Compilar

npm install
npm run build

3. Configurar Variables de Entorno (.env)

Crea tu archivo .env basΓ‘ndote en .env.example:

GTM_CLIENT_ID=tu-client-id.apps.googleusercontent.com
GTM_CLIENT_SECRET=tu-client-secret-aqui
GTM_REFRESH_TOKEN=tu-refresh-token-aqui
GTM_DEFAULT_ACCOUNT_ID=1234567890

βš™οΈ IntegraciΓ³n con Google Antigravity / Claude Desktop / Cursor

Agrega la configuraciΓ³n a tu archivo mcp_config.json:

{
  "mcpServers": {
    "google-tag-manager-mcp": {
      "command": "node",
      "args": [
        "d:/Ruta/A/google-tag-manager-mcp/dist/index.js"
      ],
      "env": {
        "GTM_CLIENT_ID": "tu-client-id.apps.googleusercontent.com",
        "GTM_CLIENT_SECRET": "tu-client-secret-aqui",
        "GTM_REFRESH_TOKEN": "tu-refresh-token-aqui",
        "GTM_DEFAULT_ACCOUNT_ID": "1234567890"
      }
    }
  }
}

Tip para desarrollo rΓ‘pido: TambiΓ©n puedes ejecutar directamente el archivo TypeScript con soporte nativo de Node.js: "args": ["--experimental-strip-types", "d:/Ruta/A/google-tag-manager-mcp/src/index.ts"]


πŸ§ͺ Casos de Uso PrΓ‘cticos

1. AuditorΓ­a Automatizada de Etiquetas HuΓ©rfanas

"Lista todas las etiquetas de mi contenedor y detecta cuΓ‘les no tienen ningΓΊn activador asociado o estΓ‘n pausadas."

2. ImplementaciΓ³n de TelemetrΓ­a para Clics en WhatsApp

"Crea una variable DataLayer para el identificador del lead, un activador para clics en la clase .btn-whatsapp y una etiqueta de evento GA4 llamada lead_whatsapp en el espacio de trabajo borrador."

3. Snapshot Seguro antes de Cambios Mayores

"Crea una versiΓ³n snapshot del estado actual del contenedor llamada 'Snapshot Pre-Lanzamiento CampaΓ±a' antes de modificar las variables de comercio electrΓ³nico."


πŸ”’ Consideraciones de Ciberseguridad

  1. Principio de MΓ­nimo Privilegio (PoLP): Las operaciones de eliminaciΓ³n de contenedores no estΓ‘n expuestas como herramientas autΓ³nomas para prevenir borrados accidentales catastrΓ³ficos.

  2. ProtecciΓ³n XSS: Siempre valida los scripts de etiquetas tipo html (HTML personalizado). El MCP encapsula los payloads en esquemas fuertemente tipados.

  3. Cero Logs Sensibles: El servidor redirige los diagnΓ³sticos a stderr sin imprimir jamΓ‘s tokens ni credenciales en la consola estΓ‘ndar reservada para el protocolo JSON-RPC.


πŸ“„ Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para mΓ‘s detalles.


Desarrollado con ❀️ por Ramiro Medina (@ramedina-ia) para la comunidad de desarrolladores y creadores de contenido de Inteligencia Artificial.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Production-grade MCP server for the Google Tag Manager API v2 with read-only GA4 (Admin + Data API) tooling. 107 tools covering the full GTM surface, including server-side containers. Ships read-only: writes, publishes, and deletes are each gated behind separate opt-in flags, every mutation requires per-call confirmation, and a dry-run mode simulates changes. Includes container audits
      203
      283 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage Google Tag Manager accounts, containers, workspaces, tags, triggers, variables, and versions via the Tag Manager API v2.
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI assistants to read and manage Google Tag Manager containers, tags, triggers, variables, and other GTM resources through the GTM API v2, with all processing running locally using the user's own Google credentials.
      24 npm
      MIT