La API de Google Health es la sucesora oficial de la API web de Fitbit. Se dirige a la API de Google Health v4 y lleva a los desarrolladores a Google OAuth 2.0. Ahora, una herramienta de línea de comandos CLI de código abierto llamada ghealth envuelve esa API para terminales y agentes de IA.
La herramienta es un binario Go único bajo la licencia Apache 2.0. Expone 40 tipos de datos verificados como JSON estructurado. Ese diseño le permite canalizar datos de sueño, frecuencia cardíaca y pasos en el contexto de un agente.
¿Qué es ghealth?
ghealth es un contenedor de la API de Google Health v4. Lo construyes desde la fuente con go build -o ghealth. Se envía como un binario autónomo.
La herramienta es explícitamente agente primero. Cada comando devuelve JSON simplificado con una forma estable. También proporciona códigos de salida deterministas, un indicador –dry-run y un indicador –raw.
El repositorio incluye dos Agent Skills como archivos SKILL.md. Uno cubre autenticación, configuración y banderas globales. El otro documenta los 40 tipos de datos, operaciones, patrones y trampas. Los agentes los instalan con el complemento de habilidades npx.
La CLI se encuentra bajo la organización Google-Health-API GitHub. Esa organización también alberga repositorios de código abierto de Fitbit de larga data.
La superficie de datos: 40 tipos verificados
Los 40 tipos cubren la mayoría de las señales de Fitbit y Pixel Watch. Los ejemplos incluyen pasos, frecuencia cardíaca, sueño, peso, saturación de oxígeno y variabilidad de la frecuencia cardíaca. Los tipos clínicos como el electrocardiograma requieren el alcance de solo lectura de ecg.
Cada tipo admite un subconjunto de operaciones. Los más comunes son lista, resumen, resumen diario y conciliación. Los tipos de escritura (ejercicio, sueño, peso, grasa corporal, altura) agregan creación, actualización y eliminación.
La operación de conciliación fusiona puntos de datos superpuestos de múltiples fuentes. Eso refleja la corriente reconciliada en la API v4.
El sueño es un buen ejemplo para el análisis de patrones. La lista predeterminada devuelve un resumen. Agregar –detail devuelve datos etapa por etapa (despierto, profundo, REM). Eso le ayuda a detectar patrones semana tras semana.
Configuración: lo que realmente sucede
La configuración se ejecuta mediante un comando: ghealth setup. Un asistente lo guiará a través del proyecto GCP y OAuth. Creas un cliente OAuth de tipo escritorio en Google Cloud Console.
Traes tus propias credenciales de OAuth. La herramienta no tiene ninguna clave compartida. Los archivos se escriben en ~/.config/ghealth/ con el modo de archivo 0600. Los tokens se actualizan automáticamente.
Todos los ámbitos de la API de Google Health están clasificados como restringidos. Google requiere una revisión de privacidad y seguridad para el acceso a producción. Para uso personal, usted autoriza su propio proyecto contra su propia cuenta. La API devuelve datos de Fitbit, Pixel Watch y fuentes de terceros conectadas.
El flujo sin cabeza utiliza PKCE con un desafío S256. También valida un parámetro de estado aleatorio al finalizar.
Práctica: comandos y resultados
La lectura de datos es consistente en todos los tipos. Cada lectura devuelve un objeto con filas debajo de los puntos de datos.
Los totales de pasos devuelven JSON agregado:
{“date”: “2026-03-28”, “countSum”: “9037”},
{“date”: “2026-03-27”, “countSum”: “2408”}
]
}
La salida se simplifica de forma predeterminada. Utilice –raw para la respuesta API original. Utilice –format csv o –format table para otras formas. El indicador -o escribe un archivo e imprime una vista previa del esquema.
La paginación no tiene pérdidas. Una lista grande devuelve un nextPageToken. Lo devuelves con –page-token para buscar la página siguiente.
Casos de uso con ejemplos
Introduzca los patrones de sueño en un agente: realice varias noches con detalle. Canalice el JSON a una sesión de Claude Code o Codex. Pídale al agente que resuma las tendencias del sueño profundo durante la semana. Cargue entrenamientos en pandas: ejecute el ejercicio de datos de ghealth export-tcx –id –output ride.csv –as csv. Cada fila es un trackpoint con frecuencia cardíaca y GPS. Luego ejecute pd.read_csv en el archivo. Cree una vista de frecuencia cardíaca en reposo: consulte la frecuencia cardíaca en reposo diaria durante 30 días. Emitir CSV con –format csv. Regístrelo en un cuaderno o en un tablero.
Cómo se compara ghealth
La siguiente tabla compara ghealth con la API sin formato y otras dos CLI. Los otros dos CLI se autoidentifican como no oficiales.
Para un control bruto, la API REST directa es la verdad básica. Para uso de terminal y agente, ghealth reduce la autenticación y el formato estándar.
Explicador interactivo