Installation

How to install the Suunto App (unofficial) integration. After installing, continue to Configuration.

Requirements

• Home Assistant 2024.12.0 or newer (declared in the manifest; the integration uses entry.runtime_data, typed config entries, modern reauth and PEP 695 type aliases).
• The Recorder integration enabled (default in HA) - required for the Long-term Statistics feature (after_dependencies: ["recorder"]).
• A working Suunto app account (the same email/password you use in the Suunto / Sports Tracker app). The watch must sync to the app - the integration reads the app's cloud, not the watch directly.
• No extra Python packages, no Docker, no Suunto partner keys (requirements: []).

2FA caveat: if your Suunto account has two-factor authentication enabled, the login call can be rejected. See Troubleshooting & FAQ.

---

Option A - HACS (recommended)

This is a custom repository (not in the default HACS store), so you add it once by URL.

1. Open HACS in Home Assistant.
2. Top-right ... → Custom repositories.
3. Repository: https://github.com/MichalZaniewicz/ha-suunto - Type: Integration → Add.
4. Search HACS for "Suunto App (unofficial)" and Download it.
5. Restart Home Assistant.

Or use the My Home Assistant shortcut:

Updates

HACS detects new versions from GitHub Releases. When a new release is published you'll see an update in HACS → download it → restart HA. To also receive beta pre-releases (X.Y.ZbN), enable "Show beta versions" on the integration in HACS.

---

Option B - Manual

1. Download the repository (a release ZIP or git clone).
2. Copy the folder custom_components/suunto_app into your HA config directory so you end up with:

   <config>/custom_components/suunto_app/__init__.py
   <config>/custom_components/suunto_app/manifest.json
   ...
   

3. Restart Home Assistant.

---

Verify it loaded

After the restart, go to Settings → Devices & Services → Add Integration and search for "Suunto App (unofficial)". If it appears, the install worked - proceed to Configuration.

If it does not appear, check Settings → System → Logs for suunto_app errors and confirm the files are under custom_components/suunto_app/ and that you restarted HA.