---
title: Samsung Health MCP connector
description: Reads Samsung Health CSV/ZIP exports for Galaxy Watch wellness context.
canonical: https://wellness.delx.ai/connectors/samsung-health
content_signal: ai-train=no, search=yes, ai-input=yes
---

# Samsung Health MCP Connector

A local parser for Samsung Health personal-data downloads that lets MCP clients summarize Galaxy Watch activity, sleep, heart, HRV, body and workout records.

## Install

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

## Agent client config

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

## Signals

- Galaxy Watch
- Sleep
- Heart Rate
- HRV
- Workouts

## Data availability

- Steps and activity: available. Parsed from Samsung Health CSV filenames and headers.
- Heart rate, resting heart rate and HRV: available. When exported by the device/account.
- Sleep and sleep stages: available. When Galaxy Watch sleep records are present.
- Workouts and exercise records: available. Duration, distance, calories and activity type when exported.
- Body metrics: available. Weight and body-fat records when logged or synced.
- Live Health Connect or Samsung Health Data SDK reads: not_available. Planned as a separate Android bridge, not this Node MCP.

## MCP 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

- `samsung_health_daily_review`
- `samsung_health_weekly_review`

## Resources

- `samsung-health://capabilities`
- `samsung-health://agent-manifest`
- `samsung-health://summary/daily`
- `samsung-health://summary/weekly`

## Privacy

- No Samsung account credential is required.
- All parsing happens from a local folder, CSV file or zip.
- The agent sees bounded MCP responses, not the user's entire export by default.
- Summary mode is the default because Samsung Health exports are sensitive.

## Best for

- Galaxy Watch weekly review
- Samsung Health local archive summarization
- Workout and sleep trend review
- No-account wellness context

## Known limits

- Not live Health Connect.
- Requires a manual export refresh.
- CSV columns can vary by app version, locale and device.

## Links

- GitHub: https://github.com/davidmosiah/samsung-health-mcp
- npm: https://www.npmjs.com/package/samsung-health-mcp-unofficial
- Provider docs: https://www.samsung.com/us/support/answer/ANS10001379/