How do I install the Apple Health CSV skill?

Run npx skillmds@latest add dvcrn/apple-health-csv in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Apple Health CSV safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Apple Health CSV?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Apple Health CSV free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Apple Health CSV?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Apple Health CSV by dvcrn — Agent Skill

Name: Apple Health CSV
Rating: 4.2 (5 reviews)
Author: dvcrn

Apple Health CSV

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, steps, sleep analysis, blood oxygen, workouts, body measurements, and more. Fully local — no cloud services, no API keys, no third-party data sharing. Use when users ask about their health data, fitness trends, sleep patterns, or want a daily health summary.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Apple Health CSV Skill

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.).

Setup

Export health data from your iPhone using an app like Simple Health Export (free)
Transfer the CSV files to your Mac (via AirDrop, iCloud, or USB)
Place them in the skill data directory:

# Default location (auto-detected)
~/.openclaw/workspace-butler/health-data/

# Or specify a custom path
export HEALTH_DATA_DIR="/path/to/your/csv/files"

Usage

# 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

Supported Metrics

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

Tips for Agents

Start with summary to get a quick overview of today's health
Use --json flag when you need structured data for analysis
Sleep data is grouped by night (cross-midnight sessions handled correctly)
Blood oxygen values are auto-converted from 0-1 decimal to percentage
Cumulative metrics (steps, calories, exercise time) show daily totals
Rate metrics (heart rate, SpO2) show daily averages with min/max range

---name: apple-health-csvdescription: 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, steps, sleep analysis, blood oxygen, workouts, body measurements, and more. Fully local — no cloud services, no API keys, no third-party data sharing. Use when users ask about their health data, fitness trends, sleep patterns, or want a daily health summary.---# Apple Health CSV SkillQuery Apple Health data from CSV exports. Works with any iOS app that exports HealthKit dataas CSV (Simple Health Export, Health Auto Export, etc.).## Setup1. Export health data from your iPhone using an app like **Simple Health Export** (free)2. Transfer the CSV files to your Mac (via AirDrop, iCloud, or USB)3. Place them in the skill data directory:```bash# Default location (auto-detected)~/.openclaw/workspace-butler/health-data/# Or specify a custom pathexport HEALTH_DATA_DIR="/path/to/your/csv/files"```## Usage```bash# List available health metricspython3 scripts/health_query.py list# Get a comprehensive daily health summarypython3 scripts/health_query.py summary# Query a specific metric (last 7 days by default)python3 scripts/health_query.py query HeartRatepython3 scripts/health_query.py query StepCount --days 14python3 scripts/health_query.py query SleepAnalysis --days 7python3 scripts/health_query.py query OxygenSaturation --days 30# JSON output for programmatic usepython3 scripts/health_query.py query HeartRate --days 7 --jsonpython3 scripts/health_query.py summary --json```## Supported Metrics| 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 |## Tips for Agents1. Start with `summary` to get a quick overview of today's health2. Use `--json` flag when you need structured data for analysis3. Sleep data is grouped by night (cross-midnight sessions handled correctly)4. Blood oxygen values are auto-converted from 0-1 decimal to percentage5. Cumulative metrics (steps, calories, exercise time) show daily totals6. Rate metrics (heart rate, SpO2) show daily averages with min/max range

Frequently asked questions