Apple Health Mcp Unofficial

Name: Apple Health Mcp Unofficial
Author: davidmosiah

@davidmosiah

Apple Health Mcp Unofficial について

Unofficial local-first Apple Health MCP server — parses your local export and exposes activity, sleep, heart, HRV and workouts to AI agents.

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

davidmosiah

投稿者

David Batista

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": [
        "-y",
        "apple-health-mcp-unofficial"
      ]
    }
  }
}

ツール

verify export path before reading data

discover available record types, date coverage, sources count and stale export risk

daily wellness brief from export data

weekly comparison and habit signals

bounded records by `type` (e.g. `HKQuantityTypeIdentifierStepCount`), `start`, `end`, `limit`

bounded workout records

re-scan the watch folder (`APPLE_HEALTH_WATCH_PATH`) and promote the newest export, refreshing summaries; pass `check_only: true` to preview without promoting

概要

What is Apple Health Mcp Unofficial?

It is a local-first MCP server that reads your Apple Health export (export.xml or export.zip) and exposes activity, sleep, HRV, and workout data to AI agents. No tokens, OAuth, or cloud sync—the export never leaves your machine.

How to use Apple Health Mcp Unofficial?

Export health data from the Health app on iPhone, transfer the zip to your computer, then run npx -y apple-health-mcp-unofficial setup --export-path /path/to/export.zip. Verify with npx -y apple-health-mcp-unofficial doctor and add the MCP server configuration to your client (Claude Desktop, Cursor, Hermes, etc.).

Key features of Apple Health Mcp Unofficial

Local-first: all data stays on your machine.
Reads export.xml, export.zip, or unzipped Apple Health folders.
Provides daily/weekly summaries, data inventory, and connection status tools.
Optional watch folder for automatic import of new exports.
Configurable privacy mode (default: summary, opt-in raw records).
Integrates with Claude Desktop, Cursor, Hermes, and other MCP clients.

Use cases of Apple Health Mcp Unofficial

Ask an AI agent for a 5‑line daily wellness brief from your Apple Health data.
Compare steps, sleep, workouts, and heart signals across the last week.
Discover which health signals and date ranges are available in your export.
Analyze long‑term health habits without manually copying numbers from the Health app.

FAQ from Apple Health Mcp Unofficial

Is this project affiliated with Apple?

No. This is an unofficial project not affiliated with, endorsed by, or supported by Apple Inc. Apple Health is a trademark of Apple Inc.

Does it access live HealthKit data directly from the iPhone?

No. It reads export.xml / export.zip files that you generate yourself from the Apple Health app. A live HealthKit bridge is a separate future component.

What data types are available?

Activity (steps, distance, energy), heart rate, sleep analysis and stages, workouts, body measurements (weight, BMI), HRV, and ECG metadata. Raw waveform requires separate PDF export.

What are the system requirements?

Node.js 20+ and an Apple Health export from your iPhone (Health app → profile → Export All Health Data).

How does the server protect my privacy?

All data is read locally; the export path is read‑only and the MCP never modifies it. Default privacy mode is summary (aggregates only), and tokens never leave your machine.