mcp-google-analytics
Provides tools for Google Analytics 4 management and reporting: listing accounts/properties, creating/updating/deleting properties and web data streams, configuring key events and custom dimensions/metrics, running basic, realtime, and free-form reports, and onboarding sites with gtag injection and tracking verification.
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.
mcp-google-analytics
Servidor MCP para Google Analytics 4: gestión de propiedades, reportes y onboarding completo de sitios nuevos (crear propiedad → stream web → sitio con gtag → métricas → verificación).
Instalación
npm install
npm run buildRelated MCP server: GA4 MCP Server
Autenticación con Google
1. Proyecto de Google Cloud
En Google Cloud Console crea o elige un proyecto.
Habilita Google Analytics Admin API y Google Analytics Data API.
En Google Auth Platform → Branding/Audience, configura la pantalla de consentimiento. Si queda en modo Testing, añade tu cuenta como usuario de prueba.
2a. OAuth de usuario (recomendado)
Google Auth Platform → Clients → Create client → Desktop app. Descarga el JSON.
Apunta
GOOGLE_OAUTH_CLIENT_FILEa ese archivo.Autoriza una vez con
npm run autho con la herramientaga_auth_login. Se abre el consentimiento de Google y el refresh token se guarda en~/.config/mcp-google-analytics/token.json(permisos 600).
Scopes solicitados: analytics.edit (crear/actualizar/borrar propiedades y streams, eventos clave) y analytics.readonly (reportes).
2b. Cuenta de servicio (servidores / CI)
Crea una cuenta de servicio y descarga su clave JSON.
En GA4, Administrar → Gestión de acceso a la cuenta, añade el email de la cuenta de servicio con rol Editor.
Define
GOOGLE_APPLICATION_CREDENTIALScon la ruta de la clave.
Si ambas opciones están configuradas, gana OAuth.
Configuración en Cursor / Claude Desktop
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/mnt/proyectos/mcp-google-analytics/dist/index.js"],
"env": {
"GOOGLE_OAUTH_CLIENT_FILE": "/ruta/client_secret.json",
"GA_MCP_DEFAULT_ACCOUNT_ID": "123456789",
"GA_MCP_SITES_DIR": "/mnt/proyectos/sitios"
}
}
}
}Variables disponibles: ver .env.example.
Herramientas
Herramienta | Qué hace |
| Muestra el modo de credenciales y si hay acceso autorizado |
| Inicia el flujo OAuth (loopback + PKCE) y devuelve la URL de consentimiento |
| Cuentas y propiedades accesibles |
| Propiedades GA4 de una cuenta ( |
| Detalle de una propiedad (incluye |
| Crea una propiedad y, opcionalmente, su stream web |
| Actualiza nombre, zona horaria, moneda o industria |
| Soft-delete (papelera) de una propiedad; recuperable en la UI hasta |
| Streams de una propiedad con sus measurement IDs |
| Crea un stream web y devuelve el snippet gtag |
| Elimina un data stream de una propiedad |
| Snippet gtag para un measurement ID |
| Eventos clave, dimensiones y métricas personalizadas |
| Usuarios, sesiones, fuentes de tráfico, páginas top y tendencia diaria |
| Reporte libre con cualquier dimensión y métrica de la Data API |
| Actividad de los últimos 30 minutos |
| KPIs del periodo y tiempo real en una sola llamada |
| Genera un sitio estático con gtag en todas las páginas |
| Inserta o actualiza gtag en HTML existente (idempotente) |
| Comprueba el tag en la URL pública y la llegada de eventos en tiempo real |
| Flujo completo de principio a fin; se puede reanudar |
| Estado guardado de cada sitio |
Flujo site_onboard
Crea la propiedad GA4, o reutiliza
propertyId.Crea el stream web para
siteUrl, o reutiliza uno existente con la misma URL, y obtiene elG-XXXX.Genera el sitio en
GA_MCP_SITES_DIR/<slug>o, si pasasexistingSiteDir, inyecta gtag en ese sitio.Configura
keyEvents,customDimensionsycustomMetricssi los pasas.Verifica: revisa el tag en
siteUrly consulta el reporte en tiempo real. ConsendTestEvent=trueenvía un evento por Measurement Protocol.
El estado se guarda en ~/.config/mcp-google-analytics/sites.json. Volver a llamar con el mismo siteName continúa donde quedó, sin duplicar la propiedad.
El servidor no publica el sitio. Despliega la carpeta generada en tu hosting y luego ejecuta site_verify_tracking.
Dashboards: limitaciones
GA4 no tiene API para crear o editar dashboards ni reportes de su interfaz. Por eso:
ga_dashboard_snapshotentrega los datos de un dashboard para que el agente los presente.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Ask your Google Analytics 4 property how the site is doing: traffic, pages, events, audit.
Read-only Google Analytics 4 MCP server for AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Google Analytics APIs to fetch reports, manage properties, data streams, conversion events, and custom dimensions/metrics through OAuth2 authentication.64 npm6MIT
- FlicenseAqualityDmaintenanceEnables interaction with Google Analytics 4 to manage accounts, run standard or realtime reports, and validate event parameters. It supports dual authentication methods and integrates with GTM for end-to-end data collection orchestration.8-
- AlicenseNot gradedqualityCmaintenanceProvides full Google Analytics 4 management and reporting capabilities via MCP, including property management, custom dimensions, audiences, events, data streams, and real-time reporting.MIT
- AlicenseBqualityDmaintenanceEnables managing Google Analytics 4 properties, data streams, conversions, and running reports using natural language through the Admin and Data APIs.2338 PyPIMIT