Apple Health MCP Server

MCP クライアントから SQL と DuckDB を使って Apple Health データを照会します。このサーバーはローカルで実行され、必要に応じて CSV エクスポートを読み取り、スキーマ探索、読み取り専用クエリ、健康サマリーのツールを提供します。

要件

• Node.js 22 以降

• Simple Health Export CSV で作成された Apple Health CSV エクスポート

ネイティブの Apple Health export.xml 形式は現在サポートされていません。

Related MCP server: apple-mcp

MCP クライアントの設定

Claude Desktop の場合、以下を ~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/unzipped/health-export"
      }
    }
  }
}

設定を変更したらクライアントを再起動します。他の MCP クライアントでも同じコマンド、引数、環境、stdio トランスポートを使用できます。

環境変数

健康データのエクスポート

1. iPhone で Simple Health Export CSV をインストールして開きます。

2. すべて を選択し、エクスポートする期間を選択します。

3. アーカイブを MCP クライアントを実行しているコンピュータに転送します。

4. 解凍し、HEALTH_DATA_DIR をそのディレクトリに設定します。

サーバーはファイルをその場で読み取ります。エクスポートをアップロードしたり、ネットワークリクエストを行ったりすることはありません。ただし、MCP クライアントに返されたクエリ結果は、そのクライアントの設定されたモデルプロバイダーに送信される可能性があります。

ツール

まず health_schema から始めてください。テーブル名はエクスポート内のファイルによって異なります。データモデルと実用的な例については、Apple Health データのクエリ を参照してください。

履歴とメモリ

テーブルを必要とする最初のリクエストは、そのテーブルの完全な CSV 履歴を読み込みます。日付ウィンドウはないため、クエリはエクスポートが遡れる限り遡ることができます。

すべてのツールが設定された履歴全体にアクセスできるため、このサーバーはそのデータを信頼できる MCP クライアントからのみ起動してください。

読み込まれたテーブルはメモリに保持され、DuckDB には上記の MAX_MEMORY_MB 制限が与えられます。約 1 GiB で 2 年間の複数テーブルのエクスポートをカバーできるため、2048MB のデフォルトには余裕があります。より大きなエクスポートの場合は MAX_MEMORY_MB を引き上げてください。サーバーは健康データの行をディスク上の一時ディレクトリに書き出すことはないため、制限に収まらないエクスポートは明示的なエラーで失敗します。

その他の現在の制限:

• Simple Health Export CSV レイアウトのみがサポートされています。

• DuckDB データベースはメモリ内にあり、サーバープロセスごとに再構築されるため、起動のたびに CSV ファイルから再読み込みされます。永続的な増分インポートは将来の作業として計画されており、現在の動作ではありません。

• デバイスの重複により、重複したように見える測定値が発生する可能性があります。クエリでは必要に応じて sourceName を考慮する必要があります。

• 健康レポートは記録されたデータを要約したものであり、医学的アドバイスではありません。

開発

git clone https://github.com/neiltron/apple-health-mcp.git
cd apple-health-mcp
bun install

npm test
npm run typecheck
npm run build

コードレイアウト、データライフサイクル、実装の制約については、アーキテクチャ を参照してください。

ライセンス

MIT