Health Bridge for AI

Install

Start with TestFlight.

The default path installs the iPhone companion without Xcode, then pairs it with the machine running your receiver and MCP client.

iOS 18 or later Read-only HealthKit Approved TestFlight build 1.0.0 (15)

Current TestFlight status: version 1.0.0 (build 15) is approved for external testing and is the only build available in the public External Beta group. The public invitation was verified without an App Store Connect session on July 19, 2026.

1. Install the iPhone companion

Open the official Apple TestFlight invitation on your iPhone and install Health Bridge for AI.

Install with TestFlight

2. Prepare your receiver host

uv tool install "git+https://github.com/roian6/apple-health-ai-bridge.git@v1.0.0"
health-bridge setup \
  --receiver-url https://your-private-host.example/v1/batches

The setup command creates the private receiver database and single-use pairing page, emits a canonical same-host stdio MCP descriptor, and verifies the local server. It does not modify any client configuration unless you explicitly choose that client.

3. Pair and enable sync

  1. Start the receiver using the command printed by setup.
  2. Open the private pairing page on the iPhone.
  3. Connect the TestFlight app.
  4. Review Apple’s native permission sheet.
  5. Enable Automatic Sync.

Health access stays read-only, and you can change Apple Health permissions at any time in iOS Settings.

Build from source

Contributors and advanced users can follow the versioned self-build guide.

Read setup guide View source