How do I install the Samsung Health skill?

Run npx skillmds@latest add lord1egypt/samsung-health in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Samsung Health safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Samsung Health?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Samsung Health free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Samsung Health?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Samsung Health by lord1egypt — Agent Skill

Name: Samsung Health
Rating: 4.2 (5 reviews)
Author: Lord1Egypt

Samsung Health

Analyze Samsung Health Connect data synced to Google Drive. Use for health tracking queries like sleep analysis, step counting, heart rate monitoring, SpO2 blood oxygen, workout history, and daily health reports. Requires Samsung Galaxy Watch/Ring with Health Connect backup to Google Drive enabled.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

Samsung Health Connect CLI

Analyze health data from Samsung Health Connect exported to Google Drive.

Prerequisites

Samsung Galaxy Watch or Galaxy Ring with Samsung Health
Samsung Health Connect app with Google Drive backup enabled
gog CLI for Google Drive access (part of Clawdbot)

Installation

cd /path/to/workspace/projects
git clone https://github.com/mudgesbot/samsung-health-skill.git
cd samsung-health-skill
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

Create ~/.config/samsung-health/config.yaml:

google_drive:
  folder_id: "YOUR_FOLDER_ID"      # From Google Drive URL
  account: "your.email@gmail.com"  # Google account for gog CLI
  file_name: "Health Connect.zip"

goals:
  daily_steps: 10000
  sleep_hours: 8

timezone: "Europe/Copenhagen"

Commands

All commands require activating the venv first:

cd /path/to/samsung-health-skill && source .venv/bin/activate

Sync Data

shealth sync              # Download latest from Google Drive
shealth sync --force      # Force re-download

Quick Daily View

shealth today             # Today's snapshot (steps, sleep, HR, SpO2)

Status

shealth status            # Data freshness, record counts, date range

Sleep Analysis

shealth sleep             # Last 7 days
shealth sleep --days 14   # Custom period

Shows: duration, stage breakdown (Light/Deep/REM/Awake), trends.

Step Tracking

shealth steps             # Last 7 days
shealth steps --week      # Weekly view
shealth steps --month     # Monthly view

Shows: daily counts, goal progress, streaks.

Heart Rate

shealth heart             # Last 7 days
shealth heart --days 14   # Custom period

Shows: average, min/max, daily trends.

Blood Oxygen (SpO2)

shealth spo2              # Last 7 days
shealth spo2 --days 14    # Custom period

Shows: average, range, trend. Normal: 95-100%.

Workouts

shealth workout           # Last 30 days
shealth workout --days 90 # Custom period

Shows: session count, duration, types (Walking, Running, Swimming, etc.)

Health Report

shealth report            # Comprehensive 7-day summary
shealth report --days 14  # Custom period

Shows: Energy Score, sleep summary, activity, heart rate.

JSON Output

Add --json flag to any command for machine-readable output:

shealth --json today
shealth --json sleep --days 7
shealth --json report

Sleep Stage Codes

Code	Stage
1	Light Sleep
4	Deep Sleep
5	Awake
6	REM Sleep

Exercise Types

Code	Type
53	Walking
33	Running
61	Hiking
21	Cycling
58	Swimming
4	Weight Training
66	Yoga

Troubleshooting

"Database not found" — Run shealth sync first.

"Google Drive not configured" — Create config.yaml with folder_id and account.

SpO2/HRV shows 0 records — Requires Galaxy Watch 4+ or Galaxy Ring; may need enabling in Samsung Health settings.

Source

GitHub: https://github.com/mudgesbot/samsung-health-skill

---name: samsung-healthdescription: Analyze Samsung Health Connect data synced to Google Drive. Use for health tracking queries like sleep analysis, step counting, heart rate monitoring, SpO2 blood oxygen, workout history, and daily health reports. Requires Samsung Galaxy Watch/Ring with Health Connect backup to Google Drive enabled.---# Samsung Health Connect CLIAnalyze health data from Samsung Health Connect exported to Google Drive.## Prerequisites- Samsung Galaxy Watch or Galaxy Ring with Samsung Health- Samsung Health Connect app with Google Drive backup enabled- `gog` CLI for Google Drive access (part of Clawdbot)## Installation```bashcd /path/to/workspace/projectsgit clone https://github.com/mudgesbot/samsung-health-skill.gitcd samsung-health-skillpython3 -m venv .venvsource .venv/bin/activatepip install -e .```## ConfigurationCreate `~/.config/samsung-health/config.yaml`:```yamlgoogle_drive: folder_id: "YOUR_FOLDER_ID" # From Google Drive URL account: "your.email@gmail.com" # Google account for gog CLI file_name: "Health Connect.zip"goals: daily_steps: 10000 sleep_hours: 8timezone: "Europe/Copenhagen"```## CommandsAll commands require activating the venv first:```bashcd /path/to/samsung-health-skill && source .venv/bin/activate```### Sync Data```bashshealth sync # Download latest from Google Driveshealth sync --force # Force re-download```### Quick Daily View```bashshealth today # Today's snapshot (steps, sleep, HR, SpO2)```### Status```bashshealth status # Data freshness, record counts, date range```### Sleep Analysis```bashshealth sleep # Last 7 daysshealth sleep --days 14 # Custom period```Shows: duration, stage breakdown (Light/Deep/REM/Awake), trends.### Step Tracking```bashshealth steps # Last 7 daysshealth steps --week # Weekly viewshealth steps --month # Monthly view```Shows: daily counts, goal progress, streaks.### Heart Rate```bashshealth heart # Last 7 daysshealth heart --days 14 # Custom period```Shows: average, min/max, daily trends.### Blood Oxygen (SpO2)```bashshealth spo2 # Last 7 daysshealth spo2 --days 14 # Custom period```Shows: average, range, trend. Normal: 95-100%.### Workouts```bashshealth workout # Last 30 daysshealth workout --days 90 # Custom period```Shows: session count, duration, types (Walking, Running, Swimming, etc.)### Health Report```bashshealth report # Comprehensive 7-day summaryshealth report --days 14 # Custom period```Shows: Energy Score, sleep summary, activity, heart rate.## JSON OutputAdd `--json` flag to any command for machine-readable output:```bashshealth --json todayshealth --json sleep --days 7shealth --json report```## Sleep Stage Codes| Code | Stage ||------|-------|| 1 | Light Sleep || 4 | Deep Sleep || 5 | Awake || 6 | REM Sleep |## Exercise Types| Code | Type ||------|------|| 53 | Walking || 33 | Running || 61 | Hiking || 21 | Cycling || 58 | Swimming || 4 | Weight Training || 66 | Yoga |## Troubleshooting**"Database not found"** — Run `shealth sync` first.**"Google Drive not configured"** — Create config.yaml with folder_id and account.**SpO2/HRV shows 0 records** — Requires Galaxy Watch 4+ or Galaxy Ring; may need enabling in Samsung Health settings.## SourceGitHub: https://github.com/mudgesbot/samsung-health-skill

Frequently asked questions