Apple Health export · free and open source

Your data,
out in the open.

Hozz carries your Apple Health records from your iPhone to places you own — your Mac, a folder, your dashboard, database, endpoint, or broker.

No account. No subscription. No Hozz cloud. Nothing leaves until you add a destination and confirm it.

  • Example heart record: heartRateVariabilitySDNN, 48 ms.
  • Example sleep record: sleepAnalysis, 7h 12m.
  • Example activity record: activeEnergyBurned, 612 kcal.
  • Example body record: bodyMass, 178.4 lb.
  • Example respiratory record: oxygenSaturation, 97%.
  • Example mind record: stateOfMind, pleasant.
  • Example mobility record: walkingSpeed, 3.1 mph.
  • Example heart record: electrocardiogram, sinus rhythm.
Real HealthKit identifiers with example readings. The lines trace every record back to its source; the colours name its category.

What Hozz can read

Not a health score.
The records themselves.

Hozz keeps HealthKit’s real type names intact. Each example below is drawn from the data the app handles; the reading beside it is an example, never a claim about a person.

  • Heart
    heartRateVariabilitySDNN48 ms

    Rate, variability, ECG, resting and walking averages

  • Activity
    stepCount8,241

    Steps, distance, energy, exercise minutes, workouts

  • Nutrition
    dietaryProtein112 g

    Everything you log to eat and drink, down to the micronutrient

  • Mobility
    walkingAsymmetryPercentage1.2%

    Walking speed, step length, asymmetry, stair speed

  • Respiratory
    oxygenSaturation97%

    Blood oxygen, respiratory rate, peak flow, VO₂ max

  • Body
    bodyMass178.4 lb

    Weight, height, body fat, lean mass, temperature

  • Sleep
    sleepAnalysis7h 12m

    Every stage, every night, from wherever you record it

  • Mind
    mindfulSession10 min

    Mindful minutes, state of mind, time in daylight

  • Cycle
    basalBodyTemperature97.9°F

    Tracking, symptoms, basal temperature, test results

  • Hearing
    headphoneAudioExposure68 dB

    Headphone and environmental audio exposure

Six destinations · no middleman

Let each record
land where you choose.

Every route ends at somewhere you control. Each destination keeps its own Health types, schedule, and place in the queue.

  • Your Mac

    Run the companion Mac app and your phone finds it on your own network — no address to type.

    _hozz._tcp · :54330
  • Folder

    iCloud Drive, Dropbox, OneDrive, Google Drive, SMB, or on the device.

    Files picker
  • Home Assistant

    Metrics land on your own dashboard as a webhook or REST call.

    Metrics JSON
  • Web address

    Your endpoint, your format. Hozz posts and retries safely.

    POST · NDJSON / JSON / CSV / Metrics / line protocol
  • InfluxDB

    Line protocol written straight in, so Grafana needs no translator.

    /api/v2/write · 1.8 /write
  • MQTT

    Published to your own broker for anything else you run.

    mqtt:// · mqtts:// · QoS 0

Seven open forms

Useful now.
Readable later.

Pick the shape the next tool needs. Hozz says when a format keeps every field and when it deliberately leaves detail behind.

Export formats, their uses, and what each retains
FormatGood forFidelity
NDJSONThe default. One record per line, streamable.Lossless for encoded fields
SQLiteQuery it in Datasette, DuckDB, pandas or Grafana.Lossless — every row keeps its original record in raw
JSONOne document, whole records.Lossless
CSVSpreadsheets and quick charts.Lossy — a grid cannot hold metadata or nested workout detail
MarkdownOne note a day, for Obsidian and journals.Lossy — a day’s totals, never the records behind them
GPXOne track per workout with GPS, for maps.A filter, not a projection — routes only
Metrics JSONDashboards, Home Assistant and MQTT.Values over time

How to export Apple Health data

One source.
Three choices.

Nothing starts in secret. You choose a destination, choose what it receives, and choose when it runs.

  1. 01

    Add a destination

    Your Mac, a folder, Home Assistant, InfluxDB, a URL, or MQTT. Test it before you trust it.

  2. 02

    Pick types and a schedule

    Per destination: which Health types, and how often — on arrival, hourly, daily or manual.

  3. 03

    Walk away

    New records go on their own. Each destination keeps its own place in the queue.

Nothing leaves your phone until you add a destination and confirm it.Hozz has no default destination and no hosted relay to receive a copy.

A current that keeps its place

Interrupted,
never quietly skipped.

Each Health type advances only after its records are durably staged. An interruption can repeat work; it cannot skip records.

  • HKAnchoredObjectQuery

    Anchors, not date windows

    Each type has its own opaque anchor, advanced only once records are durably staged.

  • checkpointed

    Resumable

    Quit it, reboot, background it. A manual export carries on from its last checkpoint.

  • Idempotency-Key

    Retries are safe

    Content-derived ids mean the same record twice is still one record.

  • quarantine · promotion

    Nothing is quietly dropped

    A record this version cannot parse is quarantined, then added once a newer one can read it.

Private by construction

The clearest promises
start with no.

Hozz’s privacy story is not a policy wrapped around a service. It is the absence of the service that would collect your data.

  • No subscription

    Nothing held back for a Pro tier.

  • No account

    Nothing to sign up to.

  • No analytics

    No telemetry, no ads, no crash payloads.

  • No server of mine

    No relay in the middle.

  • No default destination

    Nothing leaves until you add one.

  • No synced credentials

    Your keys stay in that device’s Keychain.

Hozz will never write anything back into Apple Health. Re-importing would erase where a record came from and could silently create duplicates.

Project state · early alpha

Working now.
Coverage is partial.

Hozz is not in the App Store yet. One developer is building it in the open, and the repository is available now.

Working today

  • Automatic export to six kinds of destination
  • Manual export, resumable after a crash
  • NDJSON, SQLite, JSON, CSV, Markdown and GPX
  • ECG waveforms, audiograms, routes and moods
  • Deletions carried as tombstones
  • Mac app: receives, stores, charts
  • Read-only MCP server for assistants
  • Shortcuts and a home-screen widget
  • 475 XCTest tests

Not yet

  • Every Health type — coverage is partial
  • Clinical records — compiled out of the default build
  • Writing anything back into Apple Health, ever
  • Handover between two devices
  • Accessibility and localisation pass
  • App Store release

Plain answers

Before you trust
the current.

Is Hozz free?

Yes. Free and open source under GPL-3.0, with no subscription, no account and no paid tier planned.

Where does my health data go?

Only where you send it. There is no default destination and no server of mine — nothing leaves your phone until you add a destination and confirm it.

Does it export in the background?

Yes. iOS decides when background work runs, so most types land near hourly, and Health cannot be read while your phone is locked.

Can I ask an AI about my data?

On your Mac, yes. Hozz ships a read-only MCP server that reads the database your phone keeps current, so a question costs a lookup rather than re-parsing a stale XML export. It cannot change or delete anything — but a cloud assistant may upload whatever it reads, which is the assistant’s behaviour, not Hozz’s.

Can Hozz put data back into Apple Health?

No, and it never will. Health stamps every sample with the app that wrote it, so a reading your Watch took in 2019 would come back indistinguishable from one Hozz invented — which destroys the provenance an archive exists to protect. HealthKit also has no way to say “store this unless it is already there”, so importing twice would silently double everything.

Why is there no progress percentage?

Because it would be invented. Health will not say how many records a type holds without reading all of them, so Hozz reports how many types are complete and how far back they reach, and never shows a fraction it cannot know.

Free forever · open source

Your history.
Your place to keep it.

Hozz is open source so you can read how it works before trusting it with anything.