Google Tag Manager MCP Server
Provides tools for auditing, automating, and managing Google Tag Manager Web and Server-Side containers, including listing accounts, containers, workspaces, tags, triggers, and variables; creating and updating tags, triggers, and variables in draft workspaces; creating version snapshots; and publishing versions with a confirmPublish guardrail.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π·οΈ Google Tag Manager MCP Server (GTM)
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
.cmdo.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 |
| Lista todas las cuentas de GTM asociadas a la credencial. |
| Lista los contenedores Web y Server-Side de una cuenta. |
| Obtiene detalles y configuraciΓ³n tΓ©cnica de un contenedor. |
| Lista los espacios de trabajo (workspaces) activos. |
| Inspecciona entidades modificadas/pendientes sin publicar. |
| Lista todas las etiquetas con sus estados y activadores. |
| Obtiene la configuraciΓ³n detallada de una etiqueta especΓfica. |
| Lista todos los activadores y condiciones de evento. |
| Consulta las reglas de filtrado de un activador. |
| Lista las variables personalizadas (DataLayer, DOM, Constantes). |
| Lista las variables integradas del sistema habilitadas. |
2. Escritura Segura en Borradores (Draft Workspaces)
Herramienta | DescripciΓ³n |
| Crea etiquetas (GA4, Google Ads, Meta Pixel, HTML Personalizado). |
| Modifica parΓ‘metros, activadores o pausa una etiqueta existente. |
| Crea activadores (Eventos personalizados, Clics, PΓ‘ginas vistas). |
| Crea variables personalizadas para captura de telemetrΓa. |
3. Control de Versiones y Despliegue con Guardrail
Herramienta | DescripciΓ³n |
| Congela los cambios del workspace en una versiΓ³n snapshot con notas. |
| Publica en vivo a producciΓ³n. Exige obligatoriamente |
π 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-mcp2. Instalar Dependencias y Compilar
npm install
npm run build3. 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-whatsappy una etiqueta de evento GA4 llamadalead_whatsappen 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
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.
ProtecciΓ³n XSS: Siempre valida los scripts de etiquetas tipo
html(HTML personalizado). El MCP encapsula los payloads en esquemas fuertemente tipados.Cero Logs Sensibles: El servidor redirige los diagnΓ³sticos a
stderrsin 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β¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Let AI manage your Google Tag Manager containers β tags, triggers, variables, and more.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
- AdCopilotDeprecatedcloud.adcopilot
Google Ads, GA4, Search Console and Tag Manager for AI assistants. Every change is proposed first.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables interaction with Google Tag Manager through its API with built-in Google OAuth authentication. Allows managing GTM containers, tags, triggers, and variables through natural language.250Apache 2.0
- AlicenseBqualityBmaintenanceProduction-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 audits203283 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Google Tag Manager accounts, containers, workspaces, tags, triggers, variables, and versions via the Tag Manager API v2.2Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT