Log inSubmit server
Samsung Health MCP logo

Samsung Health MCP

Reads local Samsung Health CSV or ZIP exports and exposes summaries, records, workouts, diagnostics, and reimport tools over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Samsung Health MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "samsung-health-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "delx-wellness-hermes"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y delx-wellness-hermes

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.

Overview

The samsung-health-mcp MCP server reads Samsung Health personal-data exports stored as CSV files, folders, or ZIP archives. It provides connection checks, inventory discovery, daily and weekly summaries, bounded record queries, workout listings, and export reimport through MCP tools. The server runs locally without Samsung login, OAuth, cloud API access, or direct Health Connect reads. Use it when an agent needs access to exported wellness data from a desktop environment rather than a live Samsung Health connection.

Use cases

  • Check whether a Samsung Health export is configured before querying it
  • Generate daily wellness briefs from exported health records
  • Compare weekly steps, sleep, workouts, and heart signals
  • List bounded records or workouts for a selected date range
  • Reimport the newest export from a watched folder

Key features

  • Local CSV, folder, and ZIP export parsing
  • Daily and weekly wellness summaries
  • Bounded record and workout queries
  • Export inventory and stale-data checks
  • Watch-folder reimport with preview mode
  • Optional loopback Streamable HTTP transport

Tools7

What Samsung Health MCP lets your agent do. Expand a tool for its parameters.

Self-reported~155 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

10/10 checks healthy over the last 51d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · delx-wellness-hermes (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars16Stargazers on the source repository.
npm downloads143Package downloads in the last 30 days.
Last commit20d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed7Callable tools this server registers over MCP.

How Samsung Health MCP works

What samsung-health-mcp does

The samsung-health-mcp MCP server connects MCP-compatible agents to Samsung Health data that you export yourself from the Android app. It accepts a directory containing CSV files, one CSV file, or a ZIP archive. The parser infers record types from filenames and CSV headers, allowing exports to vary by app version, locale, and device.

Available data can include steps, distance, active energy, heart rate, resting heart rate, HRV, respiratory rate, oxygen saturation, sleep, sleep stages, workouts, body weight, and body fat when those records exist in the export. The server exposes summaries and bounded data access rather than a live account connection.

How it works

After the export is copied to the computer, the server reads it locally and makes selected information available through MCP. samsung_health_connection_status checks whether the configured export path is usable. samsung_health_data_inventory reports record types, date coverage, source count, and possible staleness in the export.

Daily and weekly summary tools turn available records into wellness briefs, comparisons, and habit signals. Record access remains bounded: samsung_health_list_records accepts a record type, date range, and limit, while samsung_health_list_workouts returns bounded workout data.

A watch-folder workflow can identify a newer Samsung Health folder or ZIP and make it the active export. Reimport can be triggered with samsung_health_reimport; its check_only option previews the result without promoting the export. Summaries are refreshed after a promotion.

Setup and configuration

Export personal data in Samsung Health using More options, Settings, and Download personal data. Transfer the resulting folder or ZIP to the computer, then configure the path with the package setup command and verify it with the doctor command. The standard MCP configuration runs the package through npx and uses the default stdio transport.

For recurring imports, configure SAMSUNG_HEALTH_WATCH_PATH with a folder containing new Samsung Health exports. The server can scan that folder at startup and while running, and the reimport tool can scan it on demand. A single CSV, an export directory, and a Samsung Health ZIP are supported input forms.

The server also offers optional stateless Streamable HTTP on loopback. Start it with the HTTP flag, or configure SAMSUNG_HEALTH_MCP_TRANSPORT=http; host and port can be set with SAMSUNG_HEALTH_MCP_HOST and SAMSUNG_HEALTH_MCP_PORT.

Tools and capabilities

The samsung-health-mcp MCP server includes tools for:

  • Checking export-path status before reading data.
  • Inspecting available signals, coverage dates, sources, and stale-export risk.
  • Producing daily wellness and weekly comparison summaries.
  • Listing bounded records by type and date range.
  • Listing workout records.
  • Previewing or promoting a newer export and refreshing summaries.

Limitations and notes

This is an unofficial project and is not affiliated with Samsung Electronics. It does not log into Samsung, use a live Samsung Health cloud API, scrape accounts, or read Health Connect directly. A native Android bridge would be needed for a fully live sync.

The data is sensitive personal health information. Keep exports on trusted local storage, and do not commit CSV or ZIP files to source control, paste raw exports into chat, or upload them to issue trackers. The export path is read-only according to the project documentation. Device, region, and export contents determine which health signals are available.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Samsung Health MCP

samsung-health-mcp is an MCP server that connects AI agents to local Samsung Health CSV, folder, and ZIP exports. Its main tools check connection status, inspect data inventory, create daily and weekly summaries, list bounded records and workouts, and reimport newer exports without using Samsung login or a live cloud API.

Install it by running it through npx with the package name samsung-health-mcp-unofficial, then configure the exported Samsung Health folder or ZIP path. The README provides a standard MCP configuration using the npx command and also documents setup commands for path configuration and verification.

Yes, the README names Cursor as a supported MCP client. Configure the server using the stdio command shown in the project documentation, or use the optional local Streamable HTTP transport if that better fits your client setup.

No, it reads personal-data exports stored locally. It does not log into Samsung, access the Samsung Health cloud API, scrape accounts, or read Health Connect directly. A separate native Android bridge would be required for fully live synchronization.

Set up a watch folder with SAMSUNG_HEALTH_WATCH_PATH and place a newer Samsung Health folder or ZIP inside it. The server can promote the newest export automatically, and the samsung_health_reimport tool can rescan on demand; use check_only true to preview without promoting.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSamsung Health MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/samsung-health-mcp?style=directory)](https://allmcps.com/mcp/samsung-health-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/samsung-health-mcp"><img src="https://allmcps.com/api/badge/samsung-health-mcp?style=directory" alt="Samsung Health MCP on AllMCPs" /></a>