About Health Bridge for AI
Apple Health AI Bridge is a local bridge that lets MCP-compatible assistants query permitted Apple Health records. It is for people who want health data in AI workflows while keeping records on their own computer; access is read-only.
Key features
- 01Local sync from iPhone
- 02Read-only health record queries
- 03Sleep, workout, and activity data
- 04Automatic sync of new records
- 05Client choice for data access
Use cases
- 01Review sleep and workout history
- 02Ask an assistant about activity records
- 03Use Apple Health data in agent workflows
MCP support
The project connects MCP-compatible assistants to health records stored on the user's computer. MCP queries are read-only, and users control which clients can access the records.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README
Apple Health AI Bridge
Bring Apple Health into your AI workflow.
Quickstart · Documentation · Examples · Website · Discord
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.
- Install the app. Download the iPhone app from the App Store.
- 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.
- Pair your iPhone. Scan the pairing QR, review Apple's Health permissions, and enable Automatic Sync.
- 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
Join the community
Have a question or an idea you'd like to try? Join us on Discord for setup help, useful prompts, and conversations about using Apple Health with your AI.
You can also follow release news and see what we're working on next.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.