Plan your bridge setup.

Prepare your devices

You'll need an iPhone running iOS 18 or later and a Mac or Linux computer for the receiver. That computer stores your synced history and runs the local tools your assistant uses to read it.

Receiver setup uses a terminal. Keep the computer awake and connected when you want new records to arrive, and choose which Apple Health categories the iPhone app may read. Health access stays read-only.

Choose how to sync

Direct

Direct is the default on Mac and Linux. Your iPhone sends records to the receiver over a route you configure. For sync away from home, prepare a private HTTPS route that the phone can reach. The install guide covers the route options and connection checks.

Encrypted iCloud Mailbox on Mac

Mac users can explicitly choose Encrypted iCloud Mailbox (Beta). It delivers encrypted sync files through your own iCloud account and uses a matching receiver helper. Follow the separate Mailbox instructions linked from the install guide; the bridge never switches to this method automatically.

With either method, delivery is best-effort. iOS, network conditions, and receiver availability affect when records arrive. Check the available dates when asking about a recent period.

Choose your AI connection

Use an assistant that supports local stdio MCP on the receiver computer. The client setup catalog has nine configuration recipes; the connection guide explains how to verify access and ask your first question. The Claude Desktop guide and Hermes guide add detailed walkthroughs and troubleshooting. Direct read-only CLI queries are also available for terminal workflows.

Your records stay in storage you control, but a cloud model provider may receive the query results your client sends. Review the data flow and privacy policy before granting access.

Once your first sync succeeds, connect the assistant, check which records are available, and ask your first question. Missing records are unknown, not zero. The bridge provides records, not medical advice.

Sources and help

Check release notes and known issues at their source.

• Install guide and release-matched setup instructions
• Apple Health AI Bridge source and documentation
• Setup help and troubleshooting