samsung-health
by mudgesbot
DevOps & CloudBrief
Analyze Samsung Health Connect data synced to Google Drive.
Description
What This Skill Does
A CLI tool that downloads Samsung Health Connect data from Google Drive and lets you query it locally. Covers sleep stages, steps, heart rate, SpO2, workouts, and health reports. Works with Samsung Galaxy Watch and Galaxy Ring devices that have Health Connect Google Drive backup configured.
Exposes Samsung Health data to CLI and agent workflows that the Samsung Health app UI does not support.
When to Use It
- Checking last night's sleep stage breakdown before a morning standup
- Reviewing weekly step counts and goal streaks after adjusting a fitness routine
- Pulling heart rate trends to share with a doctor before an appointment
- Monitoring blood oxygen levels during a recovery period
- Getting a quick daily health snapshot without opening the Samsung Health app
Example Workflow
User asks: How did I sleep over the past two weeks?
- 1
Runs
shealth syncto pull the latest Health Connect backup from Google Drive - 2
Runs
shealth sleep --days 14to query the local database - 3
Parses stage breakdown: Light, Deep, REM, and Awake durations per night
- 4
Calculates average total sleep duration across the 14-day period
14-day sleep report showing nightly durations, stage percentages, and trend direction
Requirements
- Samsung Galaxy Watch or Galaxy Ring with Samsung Health app
- Samsung Health Connect app with Google Drive backup enabled
- Google account used for Drive access
- Google Drive folder ID from the Health Connect backup folder
Installation
clawhub install mudgesbot/samsung-healthRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.