samsung-health-mcp

Samsung Health MCP

Samsung Health の CSV/ZIP エクスポートをローカルで読み取ります。— アクティビティ、睡眠、心拍、ストレスに対応します。
ローカルファーストの MCP サーバー — トークンがマシンの外に出ることはありません。

⚡ Delx Wellness for Hermes で ワンコマンドインストール： npx -y delx-wellness-hermes setup — このコネクターと、専用の Hermes プロファイルに登録されたほかの 8 つを事前設定します。

または、Claude Desktop／Cursor／ChatGPT Desktop に単体で接続できます — 以下のインストールセクションをご覧ください。

---

HTTP（v2 ステートレス）

デフォルトは stdio です。Streamable HTTP はオプションで利用できます。セッション ID なし、JSON レスポンス、ループバックのみです。

npx -y samsung-health-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：SAMSUNG_HEALTH_MCP_HOST、SAMSUNG_HEALTH_MCP_PORT、SAMSUNG_HEALTH_MCP_TRANSPORT=http。

Samsung Health の個人データ CSV/ZIP エクスポートを読み取り、AI エージェントに安全に公開する、非公式のローカルファースト MCP サーバーです。

非公式プロジェクトです。 Samsung Electronics とは提携、推奨、サポート関係にありません。Samsung Health は Samsung Electronics の商標です。このパッケージは、Samsung Health アプリからご自身で生成したエクスポートを読み取ります。

Samsung Health のクラウド API には接続しません。 Samsung はパートナーアプリ向けに Android SDK の利用経路を提供していますが、この Node MCP は Samsung にログインしたり、アカウントをスクレイピングしたり、Health Connect を直接読み取ったりすることはありません。現時点ではローカルのエクスポートを読み取り、将来的には Android ブリッジを併用できるようにする予定です。

David Mosiah が、Delx Wellness の一環として開発しました。Delx Wellness は、Claude、Cursor、Hermes、OpenClaw、その他の MCP 互換エージェント向けの、ローカルファーストなウェルネス MCP コネクターのレジストリです。

これを作った理由

Samsung Health は、Galaxy Watch、Galaxy Ring、スマートフォンから、歩数、睡眠、運動、心拍数、酸素飽和度、身体測定値など、健康状態を把握するための有用なデータを収集できます。Samsung の公式 Health Data SDK を使うと、ユーザーの許可を得て、Android アプリからこれらのデータの多くにアクセスできますが、配布には Samsung のアプリ審査プロセスとパートナーシップの手続きが必要です。現在、デスクトップ MCP で信頼性を保ちながらプライバシーを守る方法は、個人データをローカルにダウンロードして利用することです。

このコネクターは、ダウンロードしたデータをローカルで読み込み、CSV ファイルのフォルダー、単一の CSV ファイル、または CSV ファイルを含む zip ファイルに対応し、範囲を限定した概要や記録を MCP 経由で提供します。Samsung の認証情報、OAuth トークン、クラウドプロキシは不要です。

60 秒でセットアップ

1. Android で、Samsung Health からデータをエクスポートします：

Samsung Health -> More options -> Settings -> Download personal data

2. ダウンロードした Samsung Health のフォルダーまたは zip ファイルを、このマシンに転送します。

3. 設定して確認します：

npx -y samsung-health-mcp-unofficial setup --export-path /path/to/SamsungHealth
npx -y samsung-health-mcp-unofficial doctor

または、CLI に Downloads、Desktop、Documents 内で最新の Samsung Health エクスポートを検索させ、管理対象のローカルストレージにコピーして、そのパスを保存します：

npx -y samsung-health-mcp-unofficial setup --auto-import

対応するエクスポートパス：

• /path/to/SamsungHealth/ または CSV ファイルを含む別のフォルダー
• /path/to/samsung_health_export.zip
• /path/to/com.samsung.health.step_count.csv

次に、MCP クライアントの設定に以下を追加します：

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

Claude Desktop の場合は、setup --client claude --export-path /path/to/SamsungHealth を実行すると、設定スニペットが自動で書き込まれます。

常に最新の状態に保つ — フォルダーを監視する（Android デバイス不要）：

npx -y samsung-health-mcp-unofficial setup --watch-path /path/to/health-exports

これで、Samsung Health アプリから個人データをダウンロードするたびに、新しい SamsungHealth フォルダー（またはその .zip ファイル、あるいは任意の *samsung*health*.zip）をそのフォルダーに置くと、コネクターは最新のエクスポートをアクティブなエクスポートに自動で切り替えます。これはサーバーの起動時にも、サーバーの実行中にも行われ、キャッシュされた概要も更新されます。また、samsung_health_reimport ツールを使って、必要に応じて再スキャンを実行できます。これはクロスプラットフォームで定期的に更新する方法です。Samsung Health と完全にリアルタイムで同期するには、ネイティブの Android Health Connect ブリッジが必要です。

エージェントで試す

Use samsung_health_connection_status to check setup, then run samsung_health_daily_summary.
Give me a 5-line wellness brief for today.

Call samsung_health_data_inventory first. What Samsung Health signals and date ranges
are available in this export?

Call samsung_health_weekly_summary with response_format=json. Compare steps,
sleep, workouts and heart signals across the last 7 days.

データの利用可否

Samsung の個人データのダウンロード内容は、アプリのバージョン、ロケール、デバイスによって異なることがあるため、パーサーは柔軟に設計されています。CSV のファイル名とヘッダーから、記録の種類を推測します。

データ	利用可能	備考
歩数	はい	samsung_health_steps
距離＋活動エネルギー	はい	CSV または運動記録に含まれる場合
心拍数＋安静時心拍数	はい	利用可能な場合、Galaxy Watch のエクスポートに含まれます
HRV、呼吸数、酸素飽和度	はい	デバイスと地域によって異なります
睡眠＋睡眠ステージ	はい	利用可能な場合、Galaxy Watch の睡眠データのエクスポートに含まれます
ワークアウト／運動	はい	時間、距離、カロリー、活動の種類
体重＋体脂肪率	はい	記録または同期されている場合
Health Connect からのリアルタイム読み取り	いいえ	Android 向けの別ブリッジとして計画中
Samsung アカウントへのログイン	いいえ	意図的に非対応

ツール

まずは以下をお試しください：

• samsung_health_connection_status - データを読み込む前にエクスポートパスを確認します
• samsung_health_data_inventory - 利用可能な記録の種類、日付範囲、ソース数、古いエクスポートのリスクを確認します
• samsung_health_daily_summary - エクスポートデータから日ごとの健康概要を作成します
• samsung_health_weekly_summary - 週ごとの比較と習慣に関する傾向を示します

診断：

• samsung_health_capabilities
• samsung_health_agent_manifest
• samsung_health_privacy_audit

記録：

• samsung_health_list_records - type、start、end、limit で範囲を限定した記録を取得します
• samsung_health_list_workouts - 範囲を限定したワークアウト記録を取得します

メンテナンス：

• samsung_health_reimport - ウォッチフォルダー（SAMSUNG_HEALTH_WATCH_PATH）を再スキャンし、最新のエクスポートに切り替えて概要を更新します。切り替えずにプレビューするには、check_only: true を指定します

プロンプトとリソース

プロンプト：

• samsung_health_daily_review
• samsung_health_weekly_review

リソース：

• samsung-health://capabilities
• samsung-health://agent-manifest
• samsung-health://inventory
• samsung-health://summary/daily
• samsung-health://summary/weekly

プライバシーと安全性

• Samsung Health のエクスポートには、機微な個人健康データが含まれます。ローカルに保管してください。
• Samsung Health の CSV／ZIP エクスポートを GitHub にコミットしたり、未加工のエクスポートをチャットに貼り付けたり、イシューにアップロードしたりしないでください。
• エクスポートのパスは読み取り専用です。MCP がソースのエクスポートを変更することはありません。
• SAMSUNG_HEALTH_PRIVACY_MODE のデフォルトは summary です。未加工レコードのダンプはオプトイン方式です。この設定はすべてのデータパスに適用されます：samsung_health_list_records、samsung_health_list_workouts、samsung_health_daily_summary（privacy_mode が structured または raw の場合に限り、個々のワークアウトレコードを返します）。
• samsung_health_weekly_summary は privacy_mode を受け付けますが、常に集計します。30 日間の未加工ワークアウトデータは、週次の集計には適していません。適用していないモードをそのまま返すのではなく、レスポンスには requested_privacy_mode（指定されたモード）、privacy_mode（常に summary。実際に適用されたモード）、および上書きについて示す privacy_disclosure が含まれます。レコード単位のデータにアクセスするには、samsung_health_daily_summary または samsung_health_list_workouts を使用してください。
• レコードとワークアウトの metadata は、拒否リストではなく許可リスト方式です。認識されたウェルネス関連の列（時刻、期間、距離、カロリー、心臓／睡眠／身体の指標、ソース名）のみがパーサーの外部に出ます。GPS 座標、高度、deviceuuid、自由記述のユーザーフィールドは解析時に除外され、どのツール、リソース、raw レスポンスにも渡りません。除外された列の数は withheld_metadata_count フィールドで報告されます。
• これは医療上の助言ではありません。このサーバーは、個人の AI ワークフロー向けにご自身でエクスポートしたデータを提供するものであり、診断や緊急時のモニタリングを行うものではありません。

設定

SAMSUNG_HEALTH_EXPORT_PATH=/path/to/SamsungHealth  # folder, csv, or zip
SAMSUNG_HEALTH_PRIVACY_MODE=summary                # summary | structured | raw
SAMSUNG_HEALTH_TIMEZONE=America/Fortaleza          # local-day summaries
SAMSUNG_HEALTH_WATCH_PATH=/path/to/health-exports  # optional: auto-reimport the newest export dropped here

setup はこれらの設定を、アクセス許可を 0600 にして ~/.samsung-health-mcp/config.json に書き込みます。

setup --auto-import は、一般的なローカルフォルダーをスキャンして最新の Samsung Health エクスポートを探し、アクセス許可を制限したうえで ~/.samsung-health-mcp/exports/ にコピーします。Samsung Health と完全にリアルタイムで同期するには、別途 Android ブリッジが必要です。

監視フォルダー（定期的な自動再インポート）

setup --watch-path <dir>（または SAMSUNG_HEALTH_WATCH_PATH）を設定すると、コネクターはフォルダーを受け取り用フォルダーとして扱います。起動時、実行中（ファイルシステムイベント経由）、および samsung_health_reimport ツールの呼び出し時に、そのフォルダー内で見つかった最新の Samsung Health エクスポート（CSV の SamsungHealth エクスポートディレクトリ、単一の *.csv、または任意の *samsung*health*.zip）をアクティブなエクスポートに切り替え、スナップショットと増分キャッシュをクリアします。これにより、次のサマリーに新しいデータが反映されます。samsung_health_connection_status は監視フォルダーの状態を報告し、より新しいエクスポートが待機している場合は警告します。完全なリアルタイム同期には、ネイティブの Android Health Connect ブリッジが必要です。

Hermes／リモートセットアップ

npx -y samsung-health-mcp-unofficial setup --client hermes --export-path /path/to/SamsungHealth
npx -y samsung-health-mcp-unofficial doctor --client hermes
hermes mcp test samsung_health

Hermes の設定を変更した後は、/reload-mcp または hermes mcp test samsung_health を使用してください。通常のエクスポートへのアクセスにゲートウェイを再起動する必要はありません。

開発

git clone https://github.com/davidmosiah/samsung-health-mcp.git
cd samsung-health-mcp
npm install
npm test

オプションのローカル HTTP トランスポート：

SAMSUNG_HEALTH_MCP_TRANSPORT=http SAMSUNG_HEALTH_MCP_PORT=3000 node dist/index.js
curl http://127.0.0.1:3000/health

公式リファレンス

• Samsung の個人データのエクスポート：https://www.samsung.com/us/support/answer/ANS10001379/
• Samsung Health Data SDK：https://developer.samsung.com/health/data/overview.html
• Samsung Health Data SDK のアプリプロセス：https://developer.samsung.com/health/data/process.html
• Android Health Connect：https://support.google.com/android/answer/12201227

リンク

• npm：https://www.npmjs.com/package/samsung-health-mcp-unofficial
• ドキュメントサイト：https://wellness.delx.ai/connectors/samsung-health
• GitHub：https://github.com/davidmosiah/samsung-health-mcp
• Delx Wellness レジストリ：https://github.com/davidmosiah/delx-wellness

---

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的なご質問、連携サポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai

スキルまたは MCP

同じパッケージに、2つの利用方法があります。MCP は stdio／HTTP でツールを登録します。スキルを使うと、クライアントに MCP がない場合でも、CLI を通じて同じツールを利用できます：

npx -y samsung-health-mcp-unofficial call samsung_health_connection_status --json '{}'

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。