ghealth
Query Google Health API v4 — steps, heart rate, exercise, sleep, weight, SpO2, HRV, ECG, blood glucose, nutrition, and 40 total data types
npx skills add Google-Health-API/google-health-cli --skill ghealth --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# ghealth CLI for the Google Health API v4. 40 verified data types. **Prerequisites:** See `../ghealth-shared/SKILL.md` for auth, setup, global flags. ## Choosing the right operation | Goal | Operation | Example | |------|-----------|---------| | Daily totals (steps, distance, calories) | `daily-rollup` | `ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29` | | Individual readings (HR, weight, SpO2) | `list` | `ghealth data heart-rate list --from today --limit 20` | | Sessions (exercise, sleep) | `list` | `ghealth data exercise list --from 2026-03-01` | | Daily summaries (resting HR, HRV, resp rate) | `list` | `ghealth data daily-resting-heart-rate list --from 2026-03-01` | | Merged multi-source data | `reconcile` | `ghealth data weight reconcile --from 2026-01-01` | **Why this matters:** `steps list` returns minute-level intervals *without counts*. Use `daily-rollup` to get actual step totals (`countSum`). Same for `distance` (`millimetersSum`) and `floors`. ## Types at a glance Run `ghealth schema types` for the live version. Quick reference: **Use daily-rollup for totals:** - `steps` → `countSum` per day - `distance` → `millimetersSum` per day - `total-calories` →
- Choosing the right operation
- Types at a glance
- Patterns the CLI can't tell you
- Exporting data for analysis
- Writing data
- Gotchas
ghealth user settings get # → timeZone: "Europe/London", utcOffset: "3600s" Then use --from/--to with the correct local dates ghealth data sleep list --limit 5 # CLI handles pagination internally ghealth data heart-rate list --from 2026-06-15 --limit 500 ghealth data heart-rate list --from 2026-06-15 --limit 500 --page-token ABC ghealth data exercise list --from today --limit 1 ghealth data steps daily-rollup --from 2026-03-24 --to 2026-03-30 --format csv -o steps.csv Sleep — nested stageMinutes auto-flattened to stageMinutes.AWAKE, stageMinutes.DEEP, etc. ghealth data sleep list --from 2026-03-01 --format csv -o sleep.csv Exercise — metricsSummary.caloriesKcal, metricsSummary.averageHeartRateBeatsPerMinute, etc.
What does the ghealth skill do?
Query Google Health API v4 — steps, heart rate, exercise, sleep, weight, SpO2, HRV, ECG, blood glucose, nutrition, and 40 total data types
How do I install it?
Run `npx skills add Google-Health-API/google-health-cli --skill ghealth --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Google-Health-API/google-health-cli, a repository with 219 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.