Home
Suunto → Home Assistant - bring your Suunto watch data (sleep, recovery, 24/7 activity, workouts, training load) into Home Assistant via the Suunto app's Sports Tracker backend. Email + password only. No Docker, no partner keys.
Suunto watch ──▶ Suunto app / Sports Tracker ──▶ Home Assistant
⚠️ Unofficial integration - not affiliated with or endorsed by Suunto / Amer Sports / Sports-Tracker. It signs in with your own account and talks to a private, undocumented API that can change or break at any time. Use your own account, at your own risk. See Privacy & Disclaimer.
One Suunto device exposing:
- 68 live sensors - sleep, recovery, daily activity, last workout, lifetime totals, weekly volume, counts, and locally-computed training-load + recovery metrics.
-
14 long-term statistics (
suunto_app:*) - hourly heart-rate / steps / energy / recovery curves and daily sleep / readiness / fitness trends, backfilled retroactively when your watch syncs late. - A workouts calendar + a recent-workouts list - your whole training history, browsable.
See the full breakdown in Sensors, Derived Metrics, Long-term Statistics and Workouts Calendar & Recent.
- Installation - add the repo to HACS and restart.
- Configuration - add the integration, log in with your Suunto email + password, tune the two poll intervals.
- Dashboard Examples - drop in ready-made Lovelace cards.
| Page | What's inside |
|---|---|
| Installation | HACS (custom repo) + manual install, requirements |
| Configuration | Login, options (poll intervals), reauth, credential model |
| Sensors | Every sensor: name, unit, source, meaning |
| Derived Metrics | CTL / ATL / TSB, ACWR, HRV/RHR baselines, Readiness - with formulas |
| Long-term Statistics | The suunto_app:* hourly/daily stats + how to chart them |
| Workouts Calendar & Recent | Calendar entity + recent-workouts list card |
| Activity Types |
activityId → name mapping + caveats |
| Data & Units | Backend fields, units and the gotchas (Hz, calories, centiseconds) |
| Architecture | Backends, the two coordinators, auth pipeline, data flow |
| Dashboard Examples | Copy-paste Lovelace YAML (gauges, charts, calendar, tables) |
| Automations & Templates | Example automations + template snippets |
| Troubleshooting & FAQ | Common issues and answers |
| Privacy & Disclaimer | ToS, data handling, security model |
| Development & Releasing | Repo layout, validation, release / beta workflow |
| Changelog | Version history |
Login pipeline ported from tajchert/suuntool. Built for the Home Assistant community as an experimental hobby project.