samsung-health-mcp — Claude Code MCP server: Samsung Health exports
Turns local Samsung Health CSV and ZIP downloads into agent-readable summaries of steps, sleep, heart and stress. Nothing leaves the machine.
claude mcp add --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> --transport stdio samsung-health-mcp -- npx -y samsung-health-mcp-unofficialWhat samsung-health-mcp does
The server opens a personal-data export from the Samsung Health app: a folder of CSVs, one CSV, or a zip that holds CSVs. Record types come from filenames and column headers, since the export layout shifts between app versions and devices. What reaches the model is a bounded set of summaries and records, exposed as tools such as samsung_health_daily_summary, samsung_health_weekly_summary, samsung_health_data_inventory and samsung_health_connection_status.
There is no cloud API here. The server never signs into a Samsung account and does not read Health Connect. You export the data on Android first (Settings, then download personal data) and copy the folder over. Point the server at it with setup --export-path or SAMSUNG_HEALTH_EXPORT_PATH, then confirm with doctor.
A watched folder saves you the repeat work: setup --watch-path promotes the newest export or *samsung*health*.zip dropped there, both at startup and while running. The samsung_health_reimport tool forces a rescan. Stdio is the default transport; --http starts a sessionless HTTP endpoint on loopback at port 3000. Unofficial project, not tied to Samsung, MIT licensed.
What it helps with
- pull a step and sleep summary from your own Samsung Health export
- see which signal types and date ranges the export contains
- compare workouts and heart rate over the last seven days
- refresh the active export as new downloads arrive
- hand health data to an agent without a cloud round trip
Example prompts for the agent
- Check setup with
samsung_health_connection_status, then give me today's daily summary. - Run
samsung_health_data_inventoryand list which signals and date ranges this export has. - Call
samsung_health_weekly_summarywithresponse_format=jsonand compare steps, sleep, workouts and heart signals for the last week.
How to install samsung-health-mcp
Platform CLI
claude mcp add --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> --transport stdio samsung-health-mcp -- npx -y samsung-health-mcp-unofficialReplace <…> with your own values
Platform CLI
codex mcp add samsung-health-mcp --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> -- npx -y samsung-health-mcp-unofficialReplace <…> with your own values
Config file
{
"mcpServers": {
"samsung-health-mcp": {
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
],
"env": {
"SAMSUNG_HEALTH_EXPORT_PATH": "<SAMSUNG_HEALTH_EXPORT_PATH>",
"SAMSUNG_HEALTH_TIMEZONE": "<SAMSUNG_HEALTH_TIMEZONE>",
"SAMSUNG_HEALTH_PRIVACY_MODE": "<SAMSUNG_HEALTH_PRIVACY_MODE>",
"SAMSUNG_HEALTH_WATCH_PATH": "<SAMSUNG_HEALTH_WATCH_PATH>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"samsung-health-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
],
"env": {
"SAMSUNG_HEALTH_EXPORT_PATH": "<SAMSUNG_HEALTH_EXPORT_PATH>",
"SAMSUNG_HEALTH_TIMEZONE": "<SAMSUNG_HEALTH_TIMEZONE>",
"SAMSUNG_HEALTH_PRIVACY_MODE": "<SAMSUNG_HEALTH_PRIVACY_MODE>",
"SAMSUNG_HEALTH_WATCH_PATH": "<SAMSUNG_HEALTH_WATCH_PATH>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> -e SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> -e SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> -e SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> samsung-health-mcp npx -y samsung-health-mcp-unofficialReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about samsung-health-mcp
How do I install samsung-health-mcp in Claude Code?
Run claude mcp add samsung-health-mcp -- npx -y samsung-health-mcp-unofficial. To pass export path, timezone and privacy mode, use the longer form with --env flags and --transport stdio.
What does samsung-health-mcp do?
It reads a local Samsung Health CSV or ZIP download and serves summaries and records about activity, sleep, heart and stress to an agent over MCP.
Does it need Samsung credentials?
No. It only touches export files you create in the app — there is no sign-in, OAuth token or cloud proxy involved.
