samsung-health-mcp-unofficial
Samsung Health
A local parser for Samsung Health personal-data downloads that lets MCP clients summarize Galaxy Watch activity, sleep, heart, HRV, body and workout records.
Best for Galaxy Watch users who want Samsung Health context in an agent without handing over a Samsung account or waiting for an Android bridge.
Quick Start
npx -y samsung-health-mcp-unofficial setup --export-path /path/to/SamsungHealth
npx -y samsung-health-mcp-unofficial doctor{
"mcpServers": {
"samsung_health": {
"command": "npx",
"args": ["-y", "samsung-health-mcp-unofficial"]
}
}
}- 01
Open Samsung Health on Android and use More options -> Settings -> Download personal data.
- 02
Transfer the downloaded Samsung Health folder or zip to the machine running the agent.
- 03
Run setup with --export-path and then doctor.
Data Availability
Steps and activity
Parsed from Samsung Health CSV filenames and headers.
Heart rate, resting heart rate and HRV
When exported by the device/account.
Sleep and sleep stages
When Galaxy Watch sleep records are present.
Workouts and exercise records
Duration, distance, calories and activity type when exported.
Body metrics
Weight and body-fat records when logged or synced.
Live Health Connect or Samsung Health Data SDK reads
Planned as a separate Android bridge, not this Node MCP.
Agent Tools
Start here
- samsung_health_connection_status
- samsung_health_data_inventory
- samsung_health_daily_summary
- samsung_health_weekly_summary
Diagnostics
- samsung_health_capabilities
- samsung_health_agent_manifest
- samsung_health_privacy_audit
Records
- samsung_health_list_records
- samsung_health_list_workouts
Prompts and Resources
Prompts
- samsung_health_daily_review
- samsung_health_weekly_review
Resources
- samsung-health://capabilities
- samsung-health://agent-manifest
- samsung-health://summary/daily
- samsung-health://summary/weekly