⚡ Instalación con un comando con Delx Wellness para Hermes:
npx -y delx-wellness-hermes setup— preconfigura este conector y los otros 8 en un perfil dedicado de Hermes.O conéctalo de forma independiente en Claude Desktop / Cursor / ChatGPT Desktop — consulta la sección de instalación a continuación.
Servidor MCP no oficial y local-first para la nueva API v4 de Google Health.
Permite que Claude, Cursor, Hermes, OpenClaw y otros clientes MCP lean datos de Google Health autorizados por el usuario desde Fitbit, Pixel Watch y fuentes de terceros compatibles a través del flujo OAuth 2.0 de Google.
Estado Beta: Google recomienda esperar hasta finales de mayo de 2026 antes de lanzar oficialmente las integraciones de la API de Google Health, ya que pueden producirse cambios importantes mientras se incorpora la opinión de los desarrolladores. Este conector se publica intencionadamente como una versión beta temprana para los desarrolladores que quieran probar la API ahora.
Proyecto no oficial. No está afiliado, respaldado ni apoyado por Google, Fitbit o Alphabet. No es un dispositivo médico. No es un consejo médico.
Se buscan probadores beta
La contribución de mayor impacto en este momento es la retroalimentación real de la configuración por parte de usuarios de Fitbit, Pixel Watch, Android y la API v4 de Google Health.
Si puedes probar con una cuenta real:
Ejecuta
npx -y google-health-mcp-unofficial doctory confirma que el flujo de OAuth es claro.Prueba
google_health_connection_status,google_health_data_inventoryygoogle_health_daily_summarydesde tu cliente MCP.Abre un issue para tipos de datos faltantes, pasos de configuración confusos, fricción específica del cliente o preocupaciones de privacidad.
No pegues tokens de OAuth, secretos de cliente o mediciones de salud personales en issues públicos.
Enlaces útiles:
Related MCP server: Withings MCP
Por qué existe esto
La API de Google Health es la sucesora de la API web de Fitbit: nuevo OAuth, nueva URL base, esquema de endpoint v4, tipos de datos estandarizados, flujos reconciliados y resúmenes.
Este MCP ofrece a los agentes una forma limpia de descubrir la API, verificar la configuración, autenticarse localmente y consultar datos sin pegar tokens en prompts o configuraciones de agentes.
Demo de 30 segundos
npx -y google-health-mcp-unofficial setup
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctorLuego inicia tu agente con:
google_health_connection_statusgoogle_health_data_inventorygoogle_health_privacy_auditgoogle_health_daily_summary
Instalación
Crea un cliente OAuth de Google Cloud, habilita la API de Google Health y añade:
http://127.0.0.1:3000/callbackLuego ejecuta:
npx -y google-health-mcp-unofficial setup
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctorScopes de solo lectura recomendados:
https://www.googleapis.com/auth/googlehealth.profile.readonly
https://www.googleapis.com/auth/googlehealth.settings.readonly
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly
https://www.googleapis.com/auth/googlehealth.nutrition.readonlyConfiguración de MCP independiente:
{
"mcpServers": {
"google_health": {
"command": "npx",
"args": ["-y", "google-health-mcp-unofficial"]
}
}
}Herramientas
Empieza aquí:
google_health_connection_status- configuración local, token, scope y preparación del clientegoogle_health_data_inventory- dominios compatibles, scopes, nomenclatura de tipos de datos y flujo del agentegoogle_health_agent_manifest- guía de instalación/ejecución legible por máquinagoogle_health_daily_summary- resumen diario beta de resúmenes y flujos reconciliadosgoogle_health_weekly_summary- revisión semanal beta
Métodos de la API de Google Health:
google_health_get_identitygoogle_health_get_profilegoogle_health_get_settingsgoogle_health_list_data_pointsgoogle_health_reconcile_data_pointsgoogle_health_daily_rollupgoogle_health_rollup
Diagnóstico:
google_health_get_auth_urlgoogle_health_exchange_codegoogle_health_privacy_auditgoogle_health_cache_statusgoogle_health_revoke_accessgoogle_health_wellness_context
Notas sobre tipos de datos
Las rutas de los endpoints usan kebab case:
steps
sleep
heart-rate
daily-resting-heart-rate
daily-heart-rate-variability
active-zone-minutes
total-calories
weight
exerciseLas expresiones de filtro usan snake case:
steps.interval.civil_start_time >= "2026-05-07"
heart_rate.sample_time.physical_time >= "2026-05-07T00:00:00Z"
sleep.interval.civil_start_time >= "2026-05-07"Familias de fuentes compatibles con la API:
users/me/dataSourceFamilies/all-sources
users/me/dataSourceFamilies/google-wearables
users/me/dataSourceFamilies/google-sourcesPrivacidad
Los tokens de OAuth se almacenan localmente en
~/.google-health-mcp/tokens.jsoncon permisos0600.Los secretos pueden vivir en
~/.google-health-mcp/config.jsono en variables de entornoGOOGLE_HEALTH_*.Las herramientas nunca devuelven tokens de acceso, tokens de actualización o secretos de cliente.
GOOGLE_HEALTH_PRIVACY_MODE=structuredes el valor predeterminado.El modo
rawes explícito y debe usarse solo para depuración o análisis profundo.
Hermes
npx -y google-health-mcp-unofficial setup --client hermes --no-auth
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor --client hermes
hermes mcp test google_healthDespués de los cambios de configuración, usa /reload-mcp o hermes mcp test google_health. No reinicies la puerta de enlace para el acceso normal a los datos.
Desarrollo
git clone https://github.com/davidmosiah/google-health-mcp.git
cd google-health-mcp
npm install
npm testEnlaces
API de Google Health: https://developers.google.com/health
Referencia REST: https://developers.google.com/health/reference/rest
Tipos de datos: https://developers.google.com/health/data-types
Guía de migración: https://developers.google.com/health/migration
Registro de Delx Wellness: https://github.com/davidmosiah/delx-wellness
Licencia
MIT - ver LICENSE.
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidmosiah/google-health-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
