Back to projects
active experiment

HealthKit-MCP

Read-only Apple Health context for MCP-capable agents.

A privacy-first bridge that syncs Apple Health aggregates from an iPhone app into a scoped backend and exposes sleep, workouts, training load, and trends through a read-only Model Context Protocol server.

Problem

Apple Health has rich personal context, but there is no normal server API an agent can read from safely.

What I built

A TypeScript MCP server, Supabase schema, and iOS HealthKit sync plan that move aggregate summaries instead of raw health samples.

Result

Health context becomes available to ChatGPT, Claude, Codex, and Claude Code through explicit read-only tools.

Audience

For personal agents that need health context without raw samples, write access, or an opaque hosted integration.

Developer setup

source without GitHub CLI git clone https://github.com/jx-grxf/HealthKit-MCP.git && cd HealthKit-MCP
source with GitHub CLI gh repo clone jx-grxf/HealthKit-MCP && cd HealthKit-MCP
latest release open https://github.com/jx-grxf/HealthKit-MCP/releases

Highlights

  • Read-only MCP tools for daily summaries, sleep, workouts, training load, and trends.
  • Demo mode runs without a backend; the Supabase path is prepared for real user isolation.
  • The iPhone side reads HealthKit locally and syncs aggregates instead of raw samples.
  • Built for ChatGPT, Claude, Codex, and Claude Code as MCP-capable clients.