Hozz

Health data, moved

Move your health data
where you use it.

Export Apple Health to destinations you choose, or open Hozz archives on Android.

Install notesGitHub
  • 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. Example readings.

Apple Health on iPhone & iPad

Not a health score.
The records themselves.

Real HealthKit types, grouped by category. Readings are examples.

  • Heart
    heartRateVariabilitySDNN48 ms

    Rate, variability, ECG and averages

  • Activity
    stepCount8,241

    Steps, distance, energy, exercise minutes, workouts

  • Nutrition
    dietaryProtein112 g

    Food, drink and nutrients

  • 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

    Sleep stages and overnight readings

  • 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 export destinations

Let each record
land where you choose.

Each destination has its own types, schedule and queue position.

  • Your Mac

    The companion app receives, stores and charts records.

    _hozz._tcp · :54330

  • Folder

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

    Files picker

  • Home Assistant

    Send metrics to a webhook or the REST API.

    Metrics JSON

  • Web address

    POST to any endpoint you run.

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

  • InfluxDB

    Write line protocol directly.

    /api/v2/write · 1.8 /write

  • MQTT

    Publish to your own broker.

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

Seven open forms

Useful now.
Readable later.

For Apple Health exports. Lossy formats say what they drop.

Export formats, their uses, and what each retains
FormatGood forFidelity
NDJSONStreaming and archives.Lossless for encoded fields
SQLiteQueries and charts.Lossless; each row keeps its raw record
JSONOne document.Lossless
CSVSpreadsheets.Lossy; drops metadata and nested detail
MarkdownDaily notes.Lossy; keeps summaries, not records
GPXOne track per workout with GPS, for maps.A filter, not a projection — routes only
Metrics JSONDashboards and automation.Values over time

How to export Apple Health data

One source.
Three choices.

Choose where, what and when.

  1. 01

    Add a destination

    Choose your Mac, a folder, Home Assistant, InfluxDB, a URL or MQTT.

  2. 02

    Pick types and a schedule

    Choose what it receives and when.

  3. 03

    Let it run

    Each destination keeps its own queue position.

Nothing leaves until you add and confirm a destination.

A current that keeps its place

Interrupted,
never quietly skipped.

An interruption can repeat work; it cannot skip records.

  • HKAnchoredObjectQuery

    Anchors, not date windows

    Each type advances only after durable staging.

  • checkpointed

    Resumable

    Manual exports resume from their last checkpoint.

  • Idempotency-Key

    Retries are safe

    Content-derived ids identify repeated batches.

  • quarantine · promotion

    Nothing is quietly dropped

    Unreadable records are quarantined for a newer version.

Private by construction

The clearest promises
start with no.

  • Open source

    GPL-3.0 with an App Store distribution exception.

  • No account

    No sign-in.

  • No analytics

    No telemetry, ads or remote crash reports.

  • No hosted relay

    No Hozz server in the middle.

  • No default destination

    Nothing is sent by default.

  • Credentials on device

    Destination credentials stay on device.

Hozz never writes to Apple Health: importing would erase provenance and can duplicate records.

Project state · beta

Working now.
Coverage is partial.

iPhone/iPad, Mac and Android preview. Not an App Store or Google Play release.

Working today

  • Apple Health export to six destinations
  • Resumable manual export
  • 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
  • Android preview: opens Hozz NDJSON/ZIP

Not yet

  • Every Health type
  • 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 or Google Play release

Questions

Plain answers.

Is Hozz open source?

Yes. Hozz is licensed under GPL-3.0 with an App Store distribution exception.

Where does my health data go?

Only to destinations you add and confirm. Hozz has no default destination or hosted relay.

Does it export in the background?

Yes, when iOS allows it. Most types are capped near hourly, and Health may be unreadable while the phone is locked.

Can I ask an AI about my data?

Yes, through the Mac app’s read-only MCP server. A cloud assistant may upload what it reads.

Can Hozz put data back into Apple Health?

No. Importing would replace the original source with Hozz and could duplicate records.

Does Android read Apple Health?

No. Android opens Hozz NDJSON/ZIP archives. Health Connect writes are experimental, opt-in and require Android 14+.

Why is there no progress percentage?

Health does not reveal a total without reading every record. Hozz reports completed types and date coverage instead.

Open source · GPL-3.0

Your history.
Your place to keep it.

Join TestFlightDownload Mac DMGAndroid preview APK