Query Apple Health data exported as CSV files from iOS apps like Simple Health Export or Health Auto Export. Supports 30+ health metrics including heart rate...
Query Apple Health data from CSV exports. Works with any iOS app that exports HealthKit data as CSV (Simple Health Export, Health Auto Export, etc.).
# Default location (auto-detected)
~/.openclaw/workspace-butler/health-data/
# Or specify a custom path
export HEALTH_DATA_DIR="/path/to/your/csv/files"
# List available health metrics
python3 scripts/health_query.py list
# Get a comprehensive daily health summary
python3 scripts/health_query.py summary
# Query a specific metric (last 7 days by default)
python3 scripts/health_query.py query HeartRate
python3 scripts/health_query.py query StepCount --days 14
python3 scripts/health_query.py query SleepAnalysis --days 7
python3 scripts/health_query.py query OxygenSaturation --days 30
# JSON output for programmatic use
python3 scripts/health_query.py query HeartRate --days 7 --json
python3 scripts/health_query.py summary --json
| Category | Metrics |
|---|---|
| Heart | HeartRate, RestingHeartRate, WalkingHeartRateAverage, HeartRateVariabilitySDNN |
| Activity | StepCount, ActiveEnergyBurned, BasalEnergyBurned, AppleExerciseTime, AppleStandTime, FlightsClimbed |
| Distance | DistanceWalkingRunning, DistanceCycling, DistanceSwimming |
| Vitals | OxygenSaturation, RespiratoryRate, BodyTemperature |
| Sleep | SleepAnalysis (with stage breakdown: REM/Core/Deep/Awake) |
| Body | BodyMass, BodyFatPercentage, BodyMassIndex, Height, LeanBodyMass |
| Walking | WalkingSpeed, WalkingStepLength, WalkingAsymmetryPercentage, WalkingDoubleSupportPercentage |
| Audio | EnvironmentalAudioExposure, HeadphoneAudioExposure |
| Performance | VO2Max, SixMinuteWalkTestDistance, AppleWalkingSteadiness |
| Other | DietaryWater, AppleSleepingWristTemperature |
summary to get a quick overview of today's health--json flag when you need structured data for analysisZIP package — ready to use