Local-first · Bonjour · TLS-PSK

Apple Health, exposed as clean JSON.

HealthKite turns your iPhone into a local, read-only server for your own Apple Health data — discovered over Bonjour, secured with TLS-PSK, and read by any MCP agent on your Mac. No cloud. No account. Nothing leaves your network.

Get started Read the wire format

Sample response

GET /day-snapshot/2026-05-10

{
  "date": "2026-05-10",
  "timezone": "America/Chicago",
  "sampleEncoding": "columnar-v1",
  "activity": {
    "steps": 9120,
    "distanceMeters": 8221.78,
    "activeEnergyKcal": 874.59,
    "exerciseMinutes": 30,
    "standHours": 3
  },
  "heart": {
    "restingBPM": 59,
    "averageBPM": 81.64,
    "hrvSDNN": 92.92,
    "vo2max": 44.14
  },
  "sleep": [
    {
      "asleepDuration": 27660,
      "inBedDuration": 33090
    }
  ],
  "workouts": []
}

Encoding: columnar-v1
Transport: TLS-PSK

01 / Overview

Your health data, on your terms

The server runs only while the app is open, on your Wi-Fi. Nothing syncs to a cloud and nothing is copied off your device.

How it connects

iPhone → local bridge → agent

The app advertises a read-only service over Bonjour. Your MCP client connects over an authenticated TLS-PSK channel and reads HealthKit-native JSON — never a shared secret on the wire.

02 / Why HealthKite

Built for agents, not dashboards

Apple's own identifier vocabulary, columnar samples, and hoisted provenance — lean enough for an LLM to read in a single pass.

Cloud calls0Nothing leaves your network

MCP tools7workouts, sleep, vitals, day snapshots

LicenseMITOpen-source · cargo install

TransportTLS-PSKBonjour-discovered, authenticated

03 / MCP tools

What your agent can read

Seven read-only tools cover workouts, sleep, standalone quantities, and whole-day rollups — all in the same columnar shape.

MCP tools — read-only, HealthKit-native
Tool	Returns	Method	Encoding	Status
get_day_snapshot	One day: sleep, steps, heart, mobility	GET	json	live
list_workouts	Paginated workout summaries	GET	columnar-v1	live
get_workout	Full workout detail by UUID	GET	columnar-v1	live
get_quantity_series	Any HealthKit quantity series	GET	columnar-v1	live
list_sleep_sessions	Reconciled sleep + phase intervals	GET	json	live

04 / Get started

Running in three minutes

Install the MCP server, toggle the LAN server in the app, and paste the pairing secret into your agent.

1 · Install: cargo install --git github.com/alpinevm/healthkite healthkite-mcp
2 · Toggle: Enable Local LAN Server in the HealthKite app
3 · Pair: Paste the pairing secret into your MCP client

05 / Start

Bring your health data to your agent

Free and open-source. Your data stays on your phone and your network.

Next step

Read the quickstart

Three minutes from install to your first query. The docs cover the wire format, every MCP tool, and the auth lifecycle.

Open the docs