Medplum MCP
Securely access and manage FHIR healthcare data stored in Medplum.
Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports.
作者による原文
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 20/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 32/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 9 (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Samsung Health MCP をインストールして。https://mcp.popnx.com/i/davidmosiah-samsung-health-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Samsung Health MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "samsung-health": { "command": "npx", "args": [ "-y", "samsung-health-mcp-unofficial" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Samsung Health MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
SettingsDeveloperEdit Config
{
"mcpServers": {
"samsung-health": {
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
]
}
}
}Samsung Health MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Samsung Health MCP を使っていると言うか、回答に Samsung Health MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SAMSUNG_HEALTH_EXPORT_PATH Samsung Health の個人データフォルダ、.csv ファイル、または CSV ファイルを含む .zip ファイルのパス。 SAMSUNG_HEALTH_TIMEZONE 日次および週次のローカル日付の要約を解釈するために使用される IANA タイムゾーン。 SAMSUNG_HEALTH_PRIVACY_MODE summary、structured、raw のいずれか。デフォルトは summary。 SAMSUNG_HEALTH_WATCH_PATH Optional folder watched for new Samsung Health exports. The newest export dropped here is auto-promoted to the active export on startup, live, and via the samsung_health_reimport tool.説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Samsung Health MCP につなげません
Samsung Health MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Samsung Health MCP につなげるアプリを使う
B · クリニック・健康 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Samsung Health MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user samsung-health -- npx -y samsung-health-mcp-unofficial 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Samsung Health MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user samsung-health -- npx -y samsung-health-mcp-unofficialSamsung Health MCP が一覧にあり、接続済みと表示されれば OK です
Samsung Health MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Samsung Health MCP を使っていると言うか、回答に Samsung Health MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SAMSUNG_HEALTH_EXPORT_PATH Samsung Health の個人データフォルダ、.csv ファイル、または CSV ファイルを含む .zip ファイルのパス。 SAMSUNG_HEALTH_TIMEZONE 日次および週次のローカル日付の要約を解釈するために使用される IANA タイムゾーン。 SAMSUNG_HEALTH_PRIVACY_MODE summary、structured、raw のいずれか。デフォルトは summary。 SAMSUNG_HEALTH_WATCH_PATH Optional folder watched for new Samsung Health exports. The newest export dropped here is auto-promoted to the active export on startup, live, and via the samsung_health_reimport tool.説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Samsung Health MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "samsung-health": { "command": "npx", "args": [ "-y", "samsung-health-mcp-unofficial" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Samsung Health MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Samsung Health MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Samsung Health MCP を使っていると言うか、回答に Samsung Health MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SAMSUNG_HEALTH_EXPORT_PATH Samsung Health の個人データフォルダ、.csv ファイル、または CSV ファイルを含む .zip ファイルのパス。 SAMSUNG_HEALTH_TIMEZONE 日次および週次のローカル日付の要約を解釈するために使用される IANA タイムゾーン。 SAMSUNG_HEALTH_PRIVACY_MODE summary、structured、raw のいずれか。デフォルトは summary。 SAMSUNG_HEALTH_WATCH_PATH Optional folder watched for new Samsung Health exports. The newest export dropped here is auto-promoted to the active export on startup, live, and via the samsung_health_reimport tool.説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Samsung Health MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "samsung-health": { "type": "stdio", "command": "npx", "args": [ "-y", "samsung-health-mcp-unofficial" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Samsung Health MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Samsung Health MCP を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Samsung Health MCP を使っていると言うか、回答に Samsung Health MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SAMSUNG_HEALTH_EXPORT_PATH Samsung Health の個人データフォルダ、.csv ファイル、または CSV ファイルを含む .zip ファイルのパス。 SAMSUNG_HEALTH_TIMEZONE 日次および週次のローカル日付の要約を解釈するために使用される IANA タイムゾーン。 SAMSUNG_HEALTH_PRIVACY_MODE summary、structured、raw のいずれか。デフォルトは summary。 SAMSUNG_HEALTH_WATCH_PATH Optional folder watched for new Samsung Health exports. The newest export dropped here is auto-promoted to the active export on startup, live, and via the samsung_health_reimport tool.説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user samsung-health -- npx -y samsung-health-mcp-unofficialClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"samsung-health": {
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"samsung-health": {
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"samsung-health": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
]
}
}
}SAMSUNG_HEALTH_EXPORT_PATH envSAMSUNG_HEALTH_TIMEZONE envSAMSUNG_HEALTH_PRIVACY_MODE envSAMSUNG_HEALTH_WATCH_PATH env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: samsung-health-mcp-unofficialこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント davidmosiah で確認済みです
コードの最終更新:14 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に samsung-health-mcp-unofficial@0.5.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/davidmosiah-samsung-health-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は14 日前、最新バージョン(0.5.0)がレジストリに届いたのは6 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Securely access and manage FHIR healthcare data stored in Medplum.
Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.
An MCP server that provides CodeScene Code Health analysis tools.
Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
| これ Samsung Health MCP | Medplum MCP | Mirobody | Codescene MCP Server | Marrow | WHOOP — MissingMCP | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | パソコンにインストールが必要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 2/3 | 3/3 | 2/4 |
| ライセンス | MIT | Apache-2.0 | Apache-2.0 | NOASSERTION | MIT | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Samsung Health MCP
Read your Samsung Health CSV/ZIP exports — activity, sleep, heart, stress — locally.
Local-first MCP server — tokens never leave your machine .
⚡ One-command install with Delx Wellness for Hermes:
npx -y delx-wellness-hermes setup— preconfigures this connector and the other 8 in a dedicated Hermes profile.
Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop — see the install section below.
Version 0.8.0 was published on 2026-11-02 and npm latest was verified at publication. Read the migration and compatibility notes before upgrading: HTTP network binds are restricted to loopback, imports/profiles have quotas, and corrected timestamps/cursor invalidation may change totals or replay records. For a pinned install, use npx -y samsung-health-mcp-unofficial@0.8.0.
Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:
npx -y samsung-health-mcp-unofficial --http
Env: SAMSUNG_HEALTH_MCP_HOST, SAMSUNG_HEALTH_MCP_PORT, SAMSUNG_HEALTH_MCP_TRANSPORT=http.
Unofficial local-first MCP server that reads Samsung Health personal-data CSV/ZIP exports and exposes them safely to AI agents.
Unofficial project. Not affiliated with, endorsed by, or supported by Samsung Electronics. Samsung Health is a trademark of Samsung Electronics. This package reads exports you generate yourself from the Samsung Health app.
No live Samsung Health cloud API. Samsung has Android SDK paths for partner apps, but this Node MCP does not log into Samsung, scrape accounts, or read Health Connect directly. It reads local exports now; a future Android bridge can sit beside it.
Built by David Mosiah as part of Delx Wellness, a registry of local-first wellness MCP connectors for Claude, Cursor, Hermes, OpenClaw and other MCP-compatible agents.
Samsung Health can collect high-signal wellness data from Galaxy Watch, Galaxy Ring and phones: steps, sleep, exercise, heart rate, oxygen saturation, body measurements and more. Samsung's official Health Data SDK can access many of these data types from Android apps with user permission, but distribution requires the Samsung app process and partnership flow. For a desktop MCP today, the reliable privacy-preserving path is a local personal-data download.
This connector reads that download locally, supports a folder of CSV files, a single CSV, or a zip containing CSV files, then exposes bounded summaries and records through MCP. No Samsung credentials, no OAuth token, no cloud proxy.
Samsung Health -> More options -> Settings -> Download personal data
npx -y samsung-health-mcp-unofficial setup --export-path /path/to/SamsungHealth
npx -y samsung-health-mcp-unofficial doctor
Or let the CLI find the newest local Samsung Health export in Downloads, Desktop or Documents, copy it into managed local storage, and save that path:
npx -y samsung-health-mcp-unofficial setup --auto-import
Supported export paths:
/path/to/SamsungHealth/ or another folder containing CSV files/path/to/samsung_health_export.zip/path/to/com.samsung.health.step_count.csvThen add this to your MCP client config:
{
"mcpServers": { "samsung_health": { "command": "npx", "args": ["-y", "samsung-health-mcp-unofficial"] } } }
For Claude Desktop, run setup --client claude --export-path /path/to/SamsungHealth and the snippet is written for you.
Keep it fresh — watch a folder (no Android device needed):
npx -y samsung-health-mcp-unofficial setup --watch-path /path/to/health-exports
Now every time you download personal data from the Samsung Health app and drop the new SamsungHealth folder (or its .zip, or any *samsung*health*.zip) into that folder, the connector auto-promotes the newest one to be the active export — on server startup and live while it runs — and refreshes the cached summaries. You can also trigger a re-scan on demand with the samsung_health_reimport tool. This is the cross-platform recurring-refresh path; a fully live Samsung Health sync still needs a native Android Health Connect bridge.
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.
The parser is intentionally flexible because Samsung personal-data downloads can vary by app version, locale and device. It infers record types from CSV filenames and headers.
| Data | Available | Notes |
|---|---|---|
| Steps | yes | samsung_health_steps |
| Distance + active energy | yes | When present in CSVs or exercise rows |
| Heart rate + resting heart rate | yes | Galaxy Watch exports when available |
| HRV, respiratory rate, oxygen saturation | yes | Device and region dependent |
| Sleep + sleep stages | yes | Galaxy Watch sleep exports when available |
| Workouts / exercise | yes | Duration, distance, calories and activity type |
| Body weight + body fat | yes | When logged or synced |
| Live Health Connect read | no | Planned separate Android bridge |
| Samsung account login | no | Deliberately unsupported |
Start with these:
samsung_health_connection_status - verify export path before reading datasamsung_health_data_inventory - discover available record types, date coverage, source count and stale export risksamsung_health_daily_summary - daily wellness brief from export datasamsung_health_weekly_summary - weekly comparison and habit signalsDiagnostics:
samsung_health_capabilitiessamsung_health_agent_manifestsamsung_health_privacy_auditRecords:
samsung_health_list_records - bounded records by type, start, end, limitsamsung_health_list_workouts - bounded workout recordsMaintenance:
samsung_health_reimport - re-scan the watch folder (SAMSUNG_HEALTH_WATCH_PATH) and promote the newest export, refreshing summaries; pass check_only: true to preview without promotingPrompts:
samsung_health_daily_reviewsamsung_health_weekly_reviewResources:
samsung-health://capabilitiessamsung-health://agent-manifestsamsung-health://inventorysamsung-health://summary/dailysamsung-health://summary/weeklySAMSUNG_HEALTH_PRIVACY_MODE defaults to summary; raw record dumps are opt-in. It applies to every data path: samsung_health_list_records, samsung_health_list_workouts and samsung_health_daily_summary (which returns individual workout records only when privacy_mode is structured or raw).samsung_health_weekly_summary accepts privacy_mode but always aggregates — a 30-day window of raw workouts is not what a weekly rollup is for. Rather than echoing back a mode it did not apply, the response carries requested_privacy_mode (what you asked for), privacy_mode (always summary, what was applied) and a privacy_disclosure naming the override. For record-level access use samsung_health_daily_summary or samsung_health_list_workouts.metadata is allowlisted, not denylisted. Only recognised wellness columns (times, durations, distances, calories, heart/sleep/body metrics, source names) leave the parser. GPS coordinates, altitude, deviceuuid and free-text user fields are dropped at parse time and never reach any tool, resource or raw response; a withheld_metadata_count field reports how many columns were dropped.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 writes these settings into ~/.samsung-health-mcp/config.json with 0600 permissions.
setup --auto-import scans common local folders for the newest Samsung Health export and copies it to ~/.samsung-health-mcp/exports/ with restrictive permissions. Fully live Samsung Health sync still requires a separate Android bridge.
setup --watch-path (or SAMSUNG_HEALTH_WATCH_PATH) makes the connector treat a folder as a drop zone. On startup, while running (via filesystem events), and whenever the samsung_health_reimport tool is called, it promotes the newest Samsung Health export found there — a SamsungHealth export directory of CSVs, a single *.csv, or any *samsung*health*.zip — to be the active export and cl