Conector de Google Analytics 4 para Claude con OAuth y sin cuentas de servicio

Rafa Villaplana ha publicado en GitHub google-analytics-oauth-mcp, un conector gratuito y de código abierto (licencia MIT) que permite a Claude consultar Google Analytics 4 iniciando sesión con la propia cuenta de Google del usuario mediante OAuth 2.0, en lugar de con una cuenta de servicio. Para quien gestiona muchas webs, el cambio evita tener que dar de alta un correo técnico en cada propiedad de Analytics, una a una.

Las claves del conector de Google Analytics 4 para Claude con OAuth en 30 segundos

Es un servidor MCP local que habla directamente con las API oficiales Admin y Data de Google Analytics, sin servidores intermedios.
Claude ve todas las propiedades de GA4 a las que ya tiene acceso la cuenta de Google del usuario, también las que se compartan después.
Solo pide permiso de lectura, analytics.readonly, y no puede cambiar configuración, usuarios ni eventos.
Se instala en Claude Desktop con un archivo .mcpb o desde el código con Node.js 20 en Claude Code.

Con un conector de cuenta de servicio, cada propiedad necesita que se añada como usuario una dirección del tipo [email protected]. En una agencia o con una cartera de clientes eso supone repetir el mismo paso decenas de veces y volver a hacerlo cada vez que llega una web nueva. Según la documentación del proyecto, aquí Claude actúa como el propio usuario: se inicia sesión una vez en el navegador y el conector hereda los permisos que esa cuenta ya tiene en Analytics.

El proyecto es compañero de search-console-oauth-mcp, del mismo autor, y puede reutilizar su cliente OAuth. No es la única vía para conectar GA4 con un asistente: Seocretos ya contó que Google Analytics 4 acerca sus datos a los agentes de IA con MCP remoto, y que herramientas como SISTRIX también apuestan por OAuth para sus integraciones con agentes.

Qué puede consultar Claude en GA4

El conector expone una docena de herramientas. Entre las más útiles para un SEO están:

list_properties y get_property: listado de cuentas y propiedades, con zona horaria, moneda, flujos de datos y eventos clave.
get_overview y compare_periods: sesiones, usuarios, interacción e ingresos frente al periodo anterior, y las landings o fuentes que más ganan o pierden.
run_report y get_report_over_time: informes libres con dimensiones, métricas, filtros con expresiones regulares y series por día, semana o mes.
get_ai_traffic: tráfico referido por asistentes como ChatGPT, Perplexity, Gemini, Copilot o Claude, con su peso sobre el total y las páginas que lo reciben.
run_realtime_report: usuarios activos en los últimos 30 minutos.

El propio autor advierte de que get_ai_traffic ofrece un mínimo y no el total real, porque muchos clics desde aplicaciones o enlaces copiados llegan a GA4 como tráfico directo. Por defecto los datos cubren los últimos 28 días completos, como la interfaz de Analytics. En la práctica, basta con preguntar en lenguaje natural cuántas sesiones orgánicas ha tenido una web este mes frente al anterior o qué landings han perdido más.

Instalación y seguridad

Antes de instalarlo hay que crear un cliente OAuth propio en Google Cloud: activar Google Analytics Admin API y Google Analytics Data API, configurar la pantalla de consentimiento y crear un cliente de tipo App de escritorio. La documentación calcula unos cinco minutos. Dos detalles evitan problemas: no subir logotipo, porque Google exige entonces verificar la app, y publicarla en producción si se usa una cuenta de Gmail, ya que en modo de prueba el acceso caduca cada siete días. Con Google Workspace basta con elegir el público interno.

En Claude Desktop se descarga el archivo .mcpb de la última versión, se abre con doble clic y se pegan el ID y el secreto del cliente. En Claude Code se clona el repositorio, se ejecuta npm install y se registra el servidor:

claude mcp add google-analytics --scope user -e GA4_OAUTH_CLIENT_ID=tu-id.apps.googleusercontent.com -e GA4_OAUTH_CLIENT_SECRET=GOCSPX-... -- node /ruta/a/google-analytics-oauth-mcp/dist/index.js

El inicio de sesión usa el flujo oficial de Google para apps de escritorio, con redirección a 127.0.0.1 y PKCE. El token de renovación se guarda en un archivo local legible solo por el usuario, y sign_out revoca el acceso en Google y lo borra. Ni el código ni el paquete llevan credenciales: cada persona crea su propio cliente OAuth. El proyecto aclara que no está afiliado a Google.

Preguntas frecuentes

¿Qué es google-analytics-oauth-mcp?

Un servidor MCP local y de código abierto que permite a Claude consultar Google Analytics 4 en lenguaje natural iniciando sesión con la cuenta de Google del usuario.

¿En qué se diferencia de un conector con cuenta de servicio?

No hay que añadir un correo de servicio en cada propiedad: Claude ve todas las propiedades a las que ya tiene acceso la cuenta que inicia sesión.

¿Puede modificar mi cuenta de Analytics?

No. Solo solicita el permiso analytics.readonly, de lectura, y no puede tocar propiedades, usuarios, eventos ni configuración.

¿Qué necesito para instalarlo?

Un cliente OAuth propio en Google Cloud con las API Admin y Data de Analytics activadas, y Claude Desktop o Node.js 20 para usarlo desde Claude Code.

Fuentes: