google-health-mcp: leer en esta máquina, con OAuth, datos de salud ya autorizados

Para quién

Ya usas Fitbit, Pixel Watch o un socio de Google Health y quieres leer en esta máquina, mediante OAuth, datos de Health API v4 que has autorizado. El texto oficial lo presenta como local-first: los tokens no salen de esta máquina. Ahora está en Beta.

La instalación recomendada apunta a Hermes: un comando preconfigura este conector y otros 8 en una configuración Hermes dedicada. El título de origen también nombra Claude y Cursor. Para quien acepta que los datos de salud salgan hacia Google, pero los tokens se queden en esta máquina.

Si no puedes completar OAuth, o no quieres que ninguna petición relacionada con salud salga de esta máquina, esta guía no te ayuda. Las notas actuales no nombran herramientas MCP concretas (pasos o ritmo cardíaco, por ejemplo). No inventes nombres de herramientas.

Primera prueba en 3 minutos

Requisitos previos: esta máquina puede ejecutar npx; planeas usar Hermes (o conectar otro cliente después). La instalación oficial de un comando es:

npx -y delx-wellness-hermes setup

Proviene de Delx Wellness for Hermes

https://github.com/davidmosiah/delx-wellness-hermes

y preconfigura este conector y otros 8. En la primera prueba no abras el scope clinical.

La primera prueba usa el comando de solo lectura nombrado coverage. La precomprobación estática antes de OAuth se escribe coverage --json; no añadas --live. El ejemplo oficial con el nombre de paquete completo solo muestra la versión de cuenta real:

npx -y google-health-mcp-unofficial coverage --live --json

En la primera prueba ejecuta primero coverage --json en el mismo paquete. Señal de éxito observable: sale un informe coverage y no deberían aparecer secretos OAuth, rutas locales ni mediciones de salud en bruto — el texto oficial dice que el comando está diseñado para eso. Aun así puede alcanzar dependencias de red; no lo leas como «sin red, sin frontera de privacidad». Tras pasar la precomprobación, añade --live si quieres una cuenta real. También es solo lectura, pero toca una cuenta real; antes de empezar, confirma que es tu propia cuenta autorizada.

SSH / contenedores / WSL pueden usar auth --manual para OAuth sin cabeza; esa no es la ruta de la primera prueba.

Casos de uso

Caso 1: ver la cobertura antes de cablear. Ejecuta coverage --json como precomprobación estática antes de OAuth. El extracto no lista campos del informe, así que el éxito es «obtener cobertura JSON y no ver secretos ni mediciones en bruto». No trates el resultado de la precomprobación como ya conectado a Fitbit.

Caso 2: contraste de solo lectura contra una cuenta real. Ejecuta npx -y google-health-mcp-unofficial coverage --live --json. El texto oficial indica solo lectura y omite a propósito secretos OAuth, rutas locales y mediciones de salud en bruto. El extracto no da parámetros de filtro ni ventana temporal; no trates esta salida como un registro clínico. El scope clinical (ECG/IRN) es opcional; no lo abras en el primer caso.

Límites de uso

Este es el nombre de paquete npm no oficial google-health-mcp-unofficial, estado Beta. Los tokens deben quedarse en esta máquina, pero las peticiones de Health API siguen saliendo de ella. coverage está diseñado para omitir mediciones en bruto; eso no equivale a que los datos nunca se hayan pedido. No hay pasos para revocar la autorización, borrar tokens locales o apagar la configuración de Hermes. Los otros 8 conectores preconfigurados juntos no se nombran. Repositorio oficial:

https://github.com/davidmosiah/google-health-mcp