Health Bridge for AI

Apple Health AI Bridge

Bring Apple Health into your AI workflow.

Quickstart · Documentation · Examples · Website

Apple Health AI Bridge connects Apple Health to MCP-compatible assistants. The iPhone app syncs the records you allow to your own computer, where your AI can query sleep, workouts, activity, and more.

Before we plan next week, what did my sleep and workouts actually look like?

Automatic sync brings new records into the same local history, without another export. Use it in the assistant you prefer or in your own agent workflows; your data isn't tied to a single AI provider.

Get started

You'll need an iPhone running iOS 18 or later, a macOS or Linux computer that can stay awake to receive records, and an AI assistant.

1. Install the app. Download the iPhone app from the App Store.
2. Set up the receiver. Install the published Receiver/CLI 1.1.5 using its tagged setup guide, including a private HTTPS route for sync away from home.
3. Pair your iPhone. Scan the pairing QR, review Apple's Health permissions, and enable Automatic Sync.
4. Connect your AI. Choose your client, then ask your first question.

For the Mac-only iCloud Mailbox Beta, use the same release's helper verification and installation guide. The maintenance release preserves 1.1.3 query behavior; newer features in main remain unreleased.

Choose your AI

Find your assistant's setup guide below.

Antigravity CLI Claude Code

Claude Desktop Codex CLI

Cursor Hermes Agent

OpenClaw OpenCode

Visual Studio Code And more

Supported data

Sleep, workouts, steps and energy, heart-rate measurements, weight, and body composition are supported. The full data catalog lists individual record types and their availability.

Privacy

Health access and MCP queries are read-only. The receiver stores your records on your computer, and you decide which clients can query them.

When you use a cloud model, the query results your client sends go to that model provider. Its privacy settings and policies apply.

Privacy policy · Security model · Remove local data

Documentation

• Install and use: Setup and troubleshooting · Supported data · Support
• Understand and build: Architecture · Compatibility · Batch protocol · SQLite schema · Brand guide
• Contribute: Development setup · Contribution ideas · Build the iPhone app

License

Apple Health AI Bridge is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Apple Inc.