Skip to main content
Glama
Apple Health AI Bridge MCP Server

Apple Health AI Bridge MCP Server

README.md
<div align="center">
  <img src="assets/brand/health-bridge-mark-512.png" alt="" width="80">
  <h1>Apple Health AI Bridge</h1>
  <p>Bring Apple Health into your AI workflow.</p>
  <p>
    <a href="https://github.com/roian6/apple-health-ai-bridge/releases"><img src="https://img.shields.io/github/v/release/roian6/apple-health-ai-bridge?filter=receiver-v%2A&amp;label=Receiver&amp;style=flat-square" alt="Receiver release" height="20"></a>
    <a href="https://scorecard.dev/viewer/?uri=github.com/roian6/apple-health-ai-bridge"><img src="https://api.scorecard.dev/projects/github.com/roian6/apple-health-ai-bridge/badge" alt="OpenSSF Scorecard" height="20"></a>
    <a href="https://www.bestpractices.dev/en/projects/15671"><img src="https://www.bestpractices.dev/projects/15671/badge" alt="OpenSSF Best Practices" height="20"></a>
    <a href="https://glama.ai/mcp/servers/roian6/apple-health-ai-bridge"><img src="https://glama.ai/mcp/servers/roian6/apple-health-ai-bridge/badges/score.svg" alt="Glama tool quality and maintenance" width="110" height="20"></a>
  </p>
  <p>
    <a href="#get-started"><strong>Quickstart</strong></a> ·
    <a href="#documentation">Documentation</a> ·
    <a href="docs/examples/weekly-review.md">Examples</a> ·
    <a href="https://healthbridge.chanhyo.dev/">Website</a> ·
    <a href="https://healthbridge.chanhyo.dev/discord/">Discord</a>
  </p>
  <p>
    <a href="https://apps.apple.com/us/app/health-bridge-for-ai/id6786152806"><img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="40"></a>
  </p>
</div>

---

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](https://apps.apple.com/us/app/health-bridge-for-ai/id6786152806). Use iOS Companion **1.2.0 (build 51)** with the Receiver below.
2. **Set up the receiver.** Install the published [Receiver/CLI 1.2.0](https://github.com/roian6/apple-health-ai-bridge/releases/tag/receiver-v1.2.0) using the [setup guide](docs/setup.md), including a private HTTPS route for sync away from home.
3. **Pair your iPhone.** [Scan the pairing QR](docs/setup.md#pair-the-iphone), review Apple's Health permissions, and enable **Automatic Sync**.
4. **Connect your AI.** [Choose your client](#choose-your-ai), then [ask your first question](docs/setup.md#ask-your-first-question).

These versions use Batch Protocol `health_bridge.batch.v1` (1.0.0). Already using the bridge? Follow the [upgrade steps](docs/setup.md#existing-users-receivercli-120-upgrade) to keep your database and pairing. For the optional Mac-only iCloud Mailbox Beta, use the [helper verification and installation guide](docs/icloud-mailbox-service.md), including its separate helper-replacement steps.

## Choose your AI

Find your assistant's setup guide below.

### AI chat apps

<table width="100%">
<tr>
<td width="50%" align="center"><a href="docs/clients.md#chatgpt-desktop"><img src="assets/clients/codex-openai-mark.svg" alt="" width="24" height="24"><br>ChatGPT Desktop</a></td>
<td width="50%" align="center"><a href="docs/clients.md#claude-desktop"><img src="assets/clients/claude-desktop-mark.svg" alt="" width="24" height="24"><br>Claude Desktop</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#lm-studio"><img src="assets/clients/lm-studio.svg" alt="" width="24" height="24"><br>LM Studio</a></td>
<td width="50%" align="center"><a href="docs/clients.md#cherry-studio"><img src="assets/clients/cherry-studio.svg" alt="" height="24"><br>Cherry Studio</a></td>
</tr>
</table>

### Agents & harnesses

<table width="100%">
<tr>
<td width="50%" align="center"><a href="docs/clients.md#openclaw-manual-configuration"><img src="assets/clients/openclaw.svg" alt="" width="24" height="24"><br>OpenClaw</a></td>
<td width="50%" align="center"><a href="docs/clients.md#hermes-agent"><img src="assets/clients/hermes-agent.svg" alt="" width="24" height="24"><br>Hermes Agent</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#goose"><img src="assets/clients/goose.svg" alt="" width="24" height="24"><br>Goose</a></td>
<td width="50%" align="center"><a href="docs/clients.md#pi"><img src="assets/clients/pi.svg" alt="" width="24" height="24"><br>Pi</a></td>
</tr>
</table>

### Coding agents & developer tools

<table width="100%">
<tr>
<td width="50%" align="center"><a href="docs/clients.md#claude-code"><img src="assets/clients/claude-code-mark.svg" alt="" width="24" height="24"><br>Claude Code</a></td>
<td width="50%" align="center"><a href="docs/clients.md#codex-cli"><img src="assets/clients/codex-openai-mark.svg" alt="" width="24" height="24"><br>Codex CLI</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#github-copilot-cli"><img src="assets/clients/github-copilot.svg" alt="" width="24" height="24"><br>GitHub Copilot CLI</a></td>
<td width="50%" align="center"><a href="docs/clients.md#cursor"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/clients/cursor-cube-2d-dark.svg"><img src="assets/clients/cursor-cube-2d-light.svg" alt="" width="21" height="24"></picture><br>Cursor</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#vs-code-local-format"><img src="assets/clients/vscode.svg" alt="" width="24" height="24"><br>Visual Studio Code</a></td>
<td width="50%" align="center"><a href="docs/clients.md#warp"><img src="assets/clients/warp.svg" alt="" width="24" height="24"><br>Warp</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#antigravity-cli"><img src="assets/clients/antigravity.svg" alt="" width="24" height="24"><br>Antigravity CLI</a></td>
<td width="50%" align="center"><a href="docs/clients.md#opencode"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/clients/opencode-logo-dark.svg"><img src="assets/clients/opencode-logo-light.svg" alt="" width="19" height="24"></picture><br>OpenCode</a></td>
</tr>
<tr>
<td width="50%" align="center"><a href="docs/clients.md#amp"><img src="assets/clients/amp.svg" alt="" width="24" height="24"><br>Amp</a></td>
<td width="50%" align="center"><a href="docs/clients.md#factory-droid"><img src="assets/clients/factory-droid.svg" alt="" width="24" height="24"><br>Factory Droid</a></td>
</tr>
</table>

[Other local MCP clients](docs/setup.md#connect-an-mcp-client-intentionally) can
use the same read-only server when their configuration supports local stdio.

## Supported data

Sleep, workouts, steps and energy, heart-rate measurements, weight, and body composition are supported. The [full data catalog](docs/supported-health-data.md) 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](https://healthbridge.chanhyo.dev/privacy) · [Security model](.github/SECURITY.md) · [Remove local data](docs/setup.md#remove-local-bridge-data)

## Join the community

Have a question or an idea you'd like to try? Join us on [Discord](https://healthbridge.chanhyo.dev/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](docs/setup.md) · [Supported data](docs/supported-health-data.md) · [Support](https://healthbridge.chanhyo.dev/support)
- **Understand and build:** [Architecture](docs/architecture.md) · [Compatibility](docs/versioning.md) · [Batch protocol](docs/reference/batch-v1.md) · [SQLite schema](docs/reference/sqlite-v1.md) · [Brand guide](docs/brand.md)
- **Contribute:** [Development setup](.github/CONTRIBUTING.md) · [Contribution ideas](docs/contribution-ideas.md) · [Build the iPhone app](docs/self-build.md)

## License

<a href="LICENSE"><img src="https://img.shields.io/github/license/roian6/apple-health-ai-bridge?label=&amp;style=flat-square" alt="License: Apache-2.0" height="20"></a>

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

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation4/5

Most tools target clearly different resources or metadata layers, but get_bridge_status and explain_sources overlap on sync/provenance, and get_bridge_context_markdown is a composite view that can blur with bridge status. Descriptions do help separate them.

Naming Consistency5/5

All tool names use consistent snake_case with a clear verb_noun pattern (get_, list_, explain_) throughout the set. No mixing of conventions or vague action names.

Tool Count5/5

Nine tools is well-scoped for a read-only health-data bridge; each covers a distinct resource or metadata layer without obvious bloat. The count sits comfortably in the ideal 3-15 range.

Completeness4/5

The surface covers bridge status/context, supported and synced metric metadata, timeseries, workouts, sleep, daily summaries, and source provenance, which is strong for a read-only bridge. Minor gaps like sync-control or deeper per-activity detail exist, but no critical dead ends for the stated read-only purpose.

Maintenance

ActivityActive
ResponsivenessUsually handled