---
title: Samsung Health MCP server for AI agents
description: Samsung Health MCP server for local CSV/ZIP exports from Galaxy Watch and Android.
canonical: https://wellness.delx.ai/connectors/samsung-health
content_signal: ai-train=no, search=yes, ai-input=yes
---

# Samsung Health MCP server for AI agents

The Samsung Health MCP server parses local personal-data downloads so MCP clients can summarize Galaxy Watch activity, sleep, heart, HRV, body and workout records.

## Short answer

The Samsung Health MCP server for AI agents is a local-first Node.js connector provided by samsung-health-mcp-unofficial. It reads a user-controlled Samsung Health CSV, folder or ZIP export from Galaxy Watch and Android, then exposes bounded activity, sleep, heart, HRV, body and workout context to Claude, Cursor and other MCP-compatible clients. It does not request a Samsung account credential, read live Health Connect data or act as a Samsung Health Data SDK bridge, and Delx does not host a copy of the export.

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

### Profile and onboarding

- `samsung_health_profile_get`
- `samsung_health_profile_update`
- `samsung_health_onboarding`

### 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.
- Profile and goals persist locally to ~/.delx-wellness/profile.json (mode 0600); shared with all 14 Delx Wellness connectors and never uploaded.

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