Apple Health

Apple Health

Auth: None (iOS device-local export; no API key) Export method: iPhone → Shortcuts app → "Export Health Data" shortcut → iCloud Drive Sync to Mac: iCloud Drive auto-syncs within minutes on same Apple ID

Data Available

Metric	Source	Notes
Steps	HealthKit	Daily total aggregated across all sources
Active energy	HealthKit	Kilocalories burned above BMR (Move ring)
Resting heart rate	HealthKit	Daily average from Apple Watch HR sensor
Body weight	HealthKit	If logged manually or from connected scale
Workout sessions	HealthKit	Type, duration, energy, distance
Stand hours	HealthKit	Stand ring progress
Exercise minutes	HealthKit	Exercise ring (green ring) minutes
Sleep (if using Apple Watch sleep tracking)	HealthKit	Total sleep, asleep/in-bed times

Note: Apple Health does not natively export HRV RMSSD or readiness scores. If both Oura and Apple Health are configured, Oura provides HRV and readiness; Apple Health provides step count and workout detail.

Configuration

Add to vault/health/config.md:

apple_health_export_path: ~/Library/Mobile Documents/com~apple~CloudDocs/HealthExports/
apple_health_export_format: csv

iOS Shortcut Setup

1. On iPhone, open the Shortcuts app
2. Create a new shortcut or download a community "Export Health Data to CSV" shortcut
3. Configure the shortcut to export the desired metrics (steps, energy, HR, weight, workouts)
4. Set the save destination to the iCloud Drive path matching apple_health_export_path in config.md
5. Run the shortcut manually when you want to update data, or add it to an Automation (e.g., every Monday morning)

Merge Behavior With Oura

When both oura and apple_health are configured as wearable_type: both in config.md:

• Steps: prefer Apple Health (typically more accurate for iPhone step counting)
• HRV and readiness: Oura only (Apple does not export these)
• Resting HR: Oura preferred if available; Apple Watch used as fallback
• Workouts: Apple Health (richer workout detail)
• Sleep score: Oura preferred; Apple Watch sleep used if Oura data is missing

Used By

• health-sync-wearable-data — read and append Apple Health daily records
• health-build-wellness-summary — supplement Oura data or serve as primary source

Vault Output

• vault/health/00_current/wearable-log.csv — daily records appended from Apple Health export