Menu
Activity, sleep, vitals, and body composition from connected wearables.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Browse and search available lab tests with prices and included markers.
Search the Betterness knowledge library — files and videos via OpenSearch full-text search.
Install, uninstall, and manage Betterness MCP server integrations for AI clients (Claude, Cursor, Windsurf).
Manage authentication — OAuth login, API key login, logout, and verify identity.
Read, update, and explore the user's health profile questionnaire (sections, questions, answers).
Shared reference: auth, global flags, output formats, and security rules for the Betterness CLI.
| name | betterness-health-data |
| version | 1.0.0 |
| description | Activity, sleep, vitals, and body composition from connected wearables. |
| metadata | {"category":"service","requires":{"bins":["betterness"]}} |
PREREQUISITE: Read
../betterness-shared/SKILL.mdfor auth, global flags, and security rules.
Four commands share the same date-range pattern for querying wearable data:
betterness <category> get --from <YYYY-MM-DD> --to <YYYY-MM-DD> --timezone <tz> --json
| Option | Description |
|---|---|
--from <YYYY-MM-DD> | Start date (default: today) |
--to <YYYY-MM-DD> | End date (default: same as --from) |
--timezone <tz> | IANA timezone (default: system timezone) |
Retrieve activity and workout data: steps, distance, calories, VO2 max, workouts.
betterness activity get --json
betterness activity get --from 2025-03-01 --to 2025-03-07 --json
Retrieve nightly sleep data: time in bed, total sleep, sleep stage breakdown.
betterness sleep get --json
betterness sleep get --from 2025-03-10 --to 2025-03-12 --json
Retrieve minute-by-minute sleep stage transitions (Deep, Core, REM, Awake).
betterness sleep stages --json
betterness sleep stages --from 2025-03-10 --json
Retrieve vital signs: heart rate, HRV, blood pressure, SpO2, glucose, respiratory rate.
betterness vitals get --json
betterness vitals get --from 2025-03-01 --to 2025-03-07 --json
Retrieve body composition: weight, body fat %, muscle mass, BMI, waist circumference.
betterness body-composition get --json
betterness body-composition get --from 2025-03-01 --to 2025-03-07 --json
betterness connected-devices list --json.--to to get a single day's data.