Help with your import.

Set up the app

You need an iPhone with iOS 17 or later and a reachable Home Assistant instance. You can reopen the setup assistant at any time in Settings.

1. Save at least one Home Assistant address. An external address and the web login require HTTPS.
2. Sign in through the Home Assistant page, or enter a long-lived token manually or by scanning its QR code. An optional client certificate is part of the connection.
3. Map import sensors to matching Apple Health data types. Select an optional export separately if needed.
4. Request the relevant Apple Health permissions. Then inspect the import preview and start a manual sync.

To explore without personal data, choose Demo in the setup assistant to open the labelled demo mode. Alternatively, choose Settings → About HA Health Bridge → Open demo mode. All examples are fictional, and no real transfer takes place.

Check the connection

First check that your Home Assistant address is reachable and entered in full. Internal and external URLs must reach the same instance. Sign in again if access has expired or been revoked.

HTTPS and home Wi-Fi

An external URL must use HTTPS. For internal HTTP, the full app variant must currently recognize a saved home Wi-Fi. iOS requires the relevant precise location permission; background recognition may require Always permission. HA Health Bridge does not request geographic coordinates.

Without Wi-Fi recognition, a configured HTTPS address is used. Installations without that feature do not support internal HTTP. A network error never enables an unsafe HTTP fallback.

Client certificates

If your server requires mTLS, import the matching PKCS#12 file and enable its client certificate. iOS still validates the server certificate. Check that certificates are valid and the hostname matches the server.

Apple Health permissions

Select the mappings and export data types you need first. In Settings → Allow Apple Health access, you can request iOS authorization for this selection again.

iOS shows its dialog only for permissions that have not already been decided. Change previously granted or denied access directly in Apple Health or iOS settings. A new request cannot force the system dialog to appear again.

Granting permission does not itself transfer data. Use the import preview to inspect a sensor mapping without writing values to Apple Health.

Preview and reports

The import preview shows new, known, corrected, skipped and pending measurements. For missing values, check the source entity, selected attribute, units and timestamps, and the history retained in Home Assistant.

Import reports show the status of each mapping. The optional export needs at least one selected, readable data type with permission. The app's own Apple Health imports are excluded from the return path.

Apple Health exports appear as sensor states. The optional HA Health Bridge integration for Home Assistant can register them in the entity registry. This does not backfill past Apple Health measurements as historical Recorder entries.

iOS controls background execution. A fixed transfer schedule is not guaranteed; a manual sync is the direct way to check the current status.

Optional Home Assistant integration

The optional export from Apple Health to Home Assistant is supported by the HA Health Bridge integration for Home Assistant 2026.11 or later. It creates registered sensors for exported values and a separate device for each iPhone export source. Stable identities preserve names, entity IDs, icons and areas you customize in Home Assistant across subsequent exports.

The public HA Health Bridge Marketplace repository on GitHub contains the Apache-2.0 source code, requirements and installation guide.

Disconnect and delete data

Disconnect Home Assistant connection

This removes the locally saved sign-in and client certificate, pauses automatic transfers and disables Apple Health export. Your configuration and mappings remain. The app attempts OAuth revocation at the server where possible; if the server cannot be reached, revoke remaining access separately in your Home Assistant profile. Remove long-lived tokens there when needed.

Delete local app data

After confirmation, this removes app settings, transfer journals, local credentials, the client certificate and export-source identifier. The action is unavailable during an active operation.

Remove Apple Health records, Home Assistant sensors, Recorder history and backups separately in their respective systems if needed. Uninstalling the app alone does not reliably remove Keychain entries. Disconnect or delete local data first, and revoke tokens at the server.

Contact support

Describe the affected transfer direction, what went wrong and the steps to reproduce it. Include the iOS version, app version, and whether you are connecting internally or over HTTPS.

Provider

Thomas Michel

Support email

ha-health-bridge@michelnet.ch

This website has no contact form or file upload. Please use the email address for support requests.

See the privacy policy for details about local data, transfers and support requests.