Apple Health · Your receiver · Your agent

Bring Apple Health context to the AI agent you choose.

Open-source Apple Health sync for local AI agents. Install the iPhone companion from TestFlight, pair a receiver you control, and query permitted observations through bounded read-only MCP or the direct local CLI.

From TestFlight to your agent in three steps.

Install, pair, and verify without building the iPhone app in Xcode.

Install

Get the iPhone companion through TestFlight. Building from source remains an advanced alternative.

Connect

Prepare a private HTTPS route, run health-bridge setup, and verify that the physical iPhone can reach the receiver before scanning its private pairing QR.

Ask

Setup emits a canonical local MCP descriptor. It never grants a client access unless you explicitly configure that client.

Ask bounded questions without inventing a dashboard.

Health Bridge supplies observations, missing-date context, and source provenance to the client you explicitly configure. These prompts are examples only, not generated answers or health claims.

  • How does recent activity compare with an earlier period?
  • What sleep or workout trends appear, and which dates are missing?
  • What would a source-aware weekly review include?

See the available Apple Health to AI workflow patterns.

A working, inspectable bridge.

The public source documents the signed receiver release and iPhone companion, supported HealthKit types, schemas, tests, security policy, bounded MCP tools, and direct CLI.

Read-only HealthKit access under your control

The app requests every implemented HealthKit read type available on the current iOS runtime. Apple’s permission sheet remains where you allow or deny individual types.

Read-only interfaces

The companion does not add, edit, or remove Apple Health records. The receiver exposes bounded query tools rather than write operations or raw SQL.

Receiver/CLI 1.1.1

The signed receiver-v1.1.1 release is compatible with iPhone Companion 1.1.0 (39) and Batch Protocol 1.0.0. On Mac, Encrypted iCloud Mailbox (Beta) is an explicit option; Direct remains the default.

Inspectable trust model

Code, supported types, protocol, schemas, tests, security guidance, and receiver ownership boundaries are available in the source repository.

Who this is for.

Health Bridge is deliberately narrower than a health platform or coaching product.

A strong fit

Privacy-conscious developers and self-hosters who want recurring delivery to infrastructure they control, can operate a private receiver route, and want explicit local-agent access.

Choose another pattern when

A manual export is enough, you do not want to operate a receiver, you need a managed hosted account, or you are looking for diagnosis, treatment, or coaching.

Compare the workflow patterns fairly.

Local-first and explicit.

Health Bridge is a bridge, not a hosted account or clinical recommendation service.