Start with the file you need
Use Apple's XML export, or choose metrics and dates
For Apple's built-in archive, open Health on your iPhone, tap your profile picture, and choose Export All Health Data. For selected metrics and dates in CSV, JSON, or Markdown, use Health.md.
Export an archive from the Health app
- Open the Health app on your iPhone and tap your profile picture or initials.
- Tap Export All Health Data and confirm the export.
- When the share sheet appears, choose where to save or send the archive.
Apple exports health and fitness data in XML, rather than a ready-made spreadsheet. See Apple's export instructions. If you already have this archive, you need a compatible reader or converter to turn its XML into CSV. Health.md's workflow reads authorized Apple Health data on your device; it does not import that XML archive.
| Your goal | Start here | What you receive |
|---|---|---|
| Keep Apple's built-in archive | Health → profile → Export All Health Data | An archive containing XML, without selecting a date range or metrics for that export. |
| Work with selected days in a spreadsheet | Export CSV with Health.md | Daily metric rows with values and units. Preview a small range first. |
| Keep health data beside your journal | Export to Obsidian | Markdown notes or Bases frontmatter in your chosen vault folder. |
| Use scripts or an agent | Choose files or agent access | Selected JSON/CSV files, or a separately configured query workflow. |
Already have Apple's archive? Follow the Apple Health XML guide to open export.xml and choose an archive conversion or a fresh CSV export.
Already tried an export? If records are missing or the file is empty, follow the Apple Health export troubleshooting checklist before exporting a larger range.
Choosing an export app? Compare Health.md and Health Auto Export for notes, CSV files, destination integrations, and automation.
Choose your source app
Check which records your source app has written to Apple Health before exporting. These guides distinguish the app's own downloads from the records available through Apple Health.
- Oura export guide: account downloads, membership requirements and shared record coverage.
- WHOOP export guide: native CSV and Apple Health sharing limits, including HRV.
- Withings export guide: native CSV and the current account eligibility rules for sharing.
- Strava export guide: activity files or shared workouts, including route restrictions.
- Dexcom G7 export guide: Clarity CSV, receiver upload and shared glucose records.
- Cronometer export guide: native diary CSV and selected shared nutrient records.
- MyFitnessPal export guide: native CSV, free website reports and shared meal-summary limits.
- Polar Flow export guide: training files, archive exclusions and workout heart-rate sharing.
Using Android? Start with the Health Connect export guide or get Health.md on Google Play. Available records and export detail differ by platform.
How it works
Three decisions, then export
Install and authorize
Download Health.md and authorize the Apple Health categories you want to share. Health permissions stay under your control, and no Health.md account is required.
Choose format, destination, and dates
Pick CSV, JSON, Markdown, or Obsidian Bases; choose a folder, your Obsidian vault, your connected Mac, or your own API endpoint; then pick a date range — today, yesterday, all time, or custom.
Preview and export
Start with one day and preview the selected format. Tap Export Data, review the written, skipped, or failed files, then open the destination folder in Files. Follow the first iPhone export walkthrough for screenshots and verification steps.
Formats
Choose a format and a destination
CSV
One file per day with the header Date,Category,Metric,Value,Unit,Timestamp. Opens in Excel, Google Sheets, or any analysis tool. Open your CSV in a spreadsheet or follow the Apple Health to Excel walkthrough or the Google Sheets walkthrough
JSON
Structured JSON for scripts, Shortcuts, and developers who want to build on their own data. JSON format details and samples
Markdown
Readable daily summaries for journals, notes, and archives — no parsing required. View a synthetic Markdown export
Obsidian vault
Write straight into your vault — daily notes and Obsidian Bases included. How the Obsidian export works. Try the free starter vault before connecting your data
Folders
Save exports to a writable folder available through Files and keep them alongside the rest of your files. If your files or vault live on a Mac, follow the Apple Health to Mac export walkthrough. Export destinations
API endpoints
POST a JSON envelope straight from your iPhone to an HTTP(S) endpoint you configure. API endpoint setup
Before you automate
Check one file, then export more
Inspect the synthetic CSV, JSON, or Markdown example before choosing a format. These production-generated reference files contain fictional data, not a person's records.
- Compare the exported date, units, and a metric with Apple Health. Availability depends on your data sources, permissions, OS, and installed app version.
- For last night's daily sleep summary on Tuesday morning, select Monday, usually Yesterday. The local journal window runs from Monday noon to Tuesday noon, including sleep that began after midnight on Tuesday. Raw source records use separate day-ownership rules. Follow the Apple Health sleep export guide, including sleep dates and daily notes.
- If a value is missing, check the selected metrics, source synchronization, and Health permissions. Missing does not mean zero.
- If Preview succeeds but saving fails, check the destination folder and file provider.
Once the result is useful, set up scheduled exports. iOS controls background timing; a target time is not a guaranteed run time.
Try Health.md on iPhone with 5 free export actions, then a one-time lifetime unlock. One action can include multiple dates and formats.
Privacy
Private by design
Core exports are local-first by default. Processing happens on your devices, and your records go to the destinations you choose. Core exports and direct device queries do not create a Health.md server copy.
No account is required for core export workflows. The separate, optional single-owner Health.md Cloud pilot retains API exports intentionally uploaded to it, with no public signup and no automatic device sync. Read the privacy policy for retention, deletion, and the pilot's unbacked storage limits. Synced folders and other endpoints follow their own terms.
For a non-synced destination, follow the export health data without the cloud guide, including its separate checks for backups and downstream apps.
Keep going
What to do with your export
For a daily weight table, follow the Apple Health weight export guide. It explains the latest-record rule, units, and when to choose original measurement records instead.
Create a PDF report
Choose measurements and dates, review coverage, then explicitly save or share a document with the Apple Health PDF export guide.
Export steps data
Verify one daily total, then build a spreadsheet trend with the Apple Health steps export guide, including source-record and duplicate checks.
Export heart rate data
Choose daily statistics or available timestamped samples with the Apple Health heart rate export guide, including separate resting-rate and HRV selections. For SDNN averages or individual readings, follow the HRV export guide.
Export workout sessions
Inspect duration, distance, and available workout details with the Apple Health workout export guide. Choose CSV for inspection or JSON to keep sessions separate.
Analyze it with AI
Drop a CSV or JSON export into Claude or ChatGPT, or connect an agent directly with scoped MCP queries. Use Apple Health with AI or follow the Apple Health to Claude walkthrough or ChatGPT walkthrough.
Just need CSV?
The spreadsheet path, start to finish: metrics, dates, and columns explained. Apple Health to CSV
Read the docs
Export contracts, format references, and setup guides for every workflow. Health.md documentation
Common questions
Frequently asked questions
Do I need Xcode or coding skills to export my Apple Health data?
No. Health.md is a shipping App Store app: you pick metrics, a date range, and a format inside the app. There is nothing to build and no scripts to run.
Does my health data leave my phone when I export it?
Only to destinations you choose. By default, core exports do not create a Health.md server copy. A folder, Obsidian vault, paired Mac, or API endpoint receives the data you select. The optional single-owner Health.md Cloud pilot retains API exports intentionally uploaded to it, with no public signup and no automatic device sync.
Is there a free trial?
The app includes 5 free export actions. After that, a one-time lifetime unlock removes the limit — Health.md does not sell a recurring consumer subscription.
Does Health.md work with Android and Health Connect?
Yes. Health.md ships a dedicated Android app for Health Connect alongside the Apple apps, with the same local-first export model.
Which formats can I export Apple Health data to?
CSV, JSON, Markdown, and Obsidian Bases, plus folder exports and API delivery. You choose the format for each export.
Is Health.md a medical app?
No. Health.md is a data portability tool, not a medical device or healthcare provider, and it does not provide medical advice.