Google Analytics MCP

Servidor MCP local para Google Analytics 4. Envuelve la API de datos de GA4 mediante herramientas centradas en informes de SEO y publicidad pagada.

Herramientas

Configuración

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

Credenciales

Copia .env.example a .env y rellena:

• GA4_PROPERTY_ID — ID numérico de la propiedad desde GA4 Admin → Configuración de la propiedad (ej. 123456789). No es el ID de medición (G-XXXXXXX).

• GOOGLE_APPLICATION_CREDENTIALS — ruta absoluta al archivo JSON de la clave de la cuenta de servicio.

Crear la cuenta de servicio

1. Ve a console.cloud.google.com → elige/crea un proyecto

2. APIs y servicios → Biblioteca → habilita Google Analytics Data API

3. IAM y administración → Cuentas de servicio → Crear cuenta de servicio (ponle un nombre como ga4-mcp)

4. En la cuenta creada → Claves → Añadir clave → Crear nueva clave → JSON → descargar

5. Guarda el JSON como service-account.json en este directorio (ya está en .gitignore)

6. En GA4 → Administrar → Gestión de acceso a la propiedad, haz clic en + → pega el correo electrónico de la cuenta de servicio (ga4-mcp@project-id.iam.gserviceaccount.com) → asigna el rol de Lector

El SDK de Google lee automáticamente GOOGLE_APPLICATION_CREDENTIALS: no se requieren cambios en el código.

Instalar en Claude Code

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

O añádelo manualmente a ~/.claude.json:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

Reinicia Claude Code después de la instalación.

Formatos de fecha

Todos los argumentos de fecha aceptan formatos de GA4:

• YYYY-MM-DD (ej. 2026-04-01)

• NdaysAgo (ej. 28daysAgo, 90daysAgo)

• yesterday, today

Valores predeterminados: 28daysAgo → yesterday.

Verificación

Una vez que las credenciales estén en su lugar:

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

Si devuelve filas, todo funciona. Errores esperados:

• GA4_PROPERTY_ID is not set — revisa .env

• PERMISSION_DENIED — la cuenta de servicio no tiene permisos de Lector en la propiedad

• 403 Google Analytics Data API has not been used — habilita la API en el proyecto de GCP

Hoja de ruta

• [ ] Herramientas de la API de administración (listar dimensiones personalizadas, eventos de conversión, audiencias) cuando sea necesario

• [ ] Search Console MCP como servidor hermano para datos de clasificaciones / impresiones / CTR (complementa a este)

• [ ] Emparejar con Demandbase MCP para combinar el tráfico de GA4 con firmografía (atribución a nivel de cuenta)