Apple Health export

How to export Apple Health data

Health.md turns the Apple Health records you authorize into CSV, JSON, Markdown, or Obsidian files you control — with the metrics and date range you choose.

No Xcode project. No scripts. No giant XML to wrangle first.

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

  1. Open the Health app on your iPhone and tap your profile picture or initials.
  2. Tap Export All Health Data and confirm the export.
  3. 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.

Choose how to export
Your goalStart hereWhat you receive
Keep Apple's built-in archiveHealth → profile → Export All Health DataAn archive containing XML, without selecting a date range or metrics for that export.
Work with selected days in a spreadsheetExport CSV with Health.mdDaily metric rows with values and units. Preview a small range first.
Keep health data beside your journalExport to ObsidianMarkdown notes or Bases frontmatter in your chosen vault folder.
Use scripts or an agentChoose files or agent accessSelected 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.

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

1

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.

2

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.

3

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.