ghealth
An official open-source command-line tool from Google, built with Go, for accessing the Google Health API. It is positioned as an interface layer for AI agents to read health data and also serves as a developer debugging tool.
Timeline (last 90 days)
ghealth is Google's officially open-sourced Google Health CLI tool, with code hosted on GitHub under the Google-Health-API organization, used to provide an interface layer for AI agents to read health data.
ghealth's open-source license is Apache 2.0, and its files carry a Google LLC copyright notice.
As of October 12, 2026, the ghealth repository has 267 stars, has not yet published any tagged release, its code version is 0.1.0, and its last commit was on July 9, 2026.
ghealth requires Go 1.23 or higher and Git to build from source.
ghealth's credential files are stored under ~/.config/ghealth/, where credentials.json stores the access and refresh tokens in plaintext.
The ghealth refresh token for test-status projects expires after 7 days, requiring a weekly re-login.
ghealth commands follow the unified pattern of ghealth data + data type + operation, with results returned as JSON, for example ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29.
daily-rollup returns summary values aggregated by day, suitable for cumulative metrics such as steps, distance, and calories; list returns raw collection points or sessions, suitable for high-frequency sampled data such as heart rate and HRV; summing on your own with list may be inconsistent with daily-rollup results.
The ghealth repository comes with two SKILL.md skill files, covering configuration and login and the pitfalls of 40 data types respectively, which can be registered via npx skills add into agent frameworks that support this convention (such as Claude Code and Codex).
ghealth uses 6 exit codes (0-5) to indicate the type of success or failure, and errors are also output as JSON, so agents can branch the flow and retry based on the exit code and JSON fields.
2 more timeline events
All Facts (12)
ghealth is Google's officially open-sourced Google Health CLI tool, with code hosted on GitHub under the Google-Health-API organization, used to provide an interface layer for AI agents to read health data.
50%Unverifiedghealth's open-source license is Apache 2.0, and its files carry a Google LLC copyright notice.
50%UnverifiedAs of October 12, 2026, the ghealth repository has 267 stars, has not yet published any tagged release, its code version is 0.1.0, and its last commit was on July 9, 2026.
50%Unverifiedghealth requires Go 1.23 or higher and Git to build from source.
50%Unverifiedghealth's credential files are stored under ~/.config/ghealth/, where credentials.json stores the access and refresh tokens in plaintext.
50%UnverifiedThe ghealth refresh token for test-status projects expires after 7 days, requiring a weekly re-login.
50%Unverifiedghealth commands follow the unified pattern of ghealth data + data type + operation, with results returned as JSON, for example ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29.
50%Unverifieddaily-rollup returns summary values aggregated by day, suitable for cumulative metrics such as steps, distance, and calories; list returns raw collection points or sessions, suitable for high-frequency sampled data such as heart rate and HRV; summing on your own with list may be inconsistent with daily-rollup results.
50%UnverifiedThe ghealth repository comes with two SKILL.md skill files, covering configuration and login and the pitfalls of 40 data types respectively, which can be registered via npx skills add into agent frameworks that support this convention (such as Claude Code and Codex).
50%Unverifiedghealth uses 6 exit codes (0-5) to indicate the type of success or failure, and errors are also output as JSON, so agents can branch the flow and retry based on the exit code and JSON fields.
50%Unverifiedghealth can access 40 data types, of which five types support writing: workout, sleep, weight, body fat and height, but the writing function is not yet complete.
50%Unverifiedghealth cannot access women's health types, the skin temperature type in preview, and blood pressure (the related feature request has remained open since August 20).
50%