Oura Ring for Home Assistant (Marketplace integration)

Installs: 441 sharing analytics
GitHub stars: 66
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v2.11.0, October 27, 2026
Category: Security and safety, Cameras
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: oura
Source: github.com/louispires/Oura-Home-Assistant-Integration
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of louispires/Oura-Home-Assistant-Integration.

About

Oura Ring is a Home Assistant integration that reads Oura Ring data through Oura's v2 cloud API with OAuth2 sign-in. It adds sensors for sleep, readiness, activity, heart rate, stress and workouts, plus binary sensors for rest mode and ring charging. On first setup it imports a configurable span of past data into long-term statistics, stamped with the original dates, so history charts show earlier values. A daily reconcile re-imports a recent window so data that Oura syncs late lands on the correct date, and an action can run the same re-import by hand. Options cover the update interval, the months of history to load, and the reconcile window. Features missing from a ring or membership stay unavailable, and setup runs in the UI with Oura application credentials.

Automatic summary of the README and code of louispires/Oura-Home-Assistant-Integration. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Sign in with the vendor Connects through the vendor's own sign-in page.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

After setup

Update interval (minutes)How often to fetch new data from Oura API (1-60 minutes)
Historical months to load (1-48, only applies on first setup)Number of months of historical data to import on first setup or when re-importing (1-48 months, up to 4 years)
Statistics reconcile window (days)How many recent days to re-import into long-term statistics once per day, so late-arriving Oura data backfills the correct dates (0 disables, max 30)
Historical data already importedToggle OFF to re-import historical data on next restart (will fetch the configured number of months). WARNING: This will trigger a full historical data import!

Texts from the code of louispires/Oura-Home-Assistant-Integration.

Entities

Binary sensorsRest mode, Ring charging
SensorsSleep score, Total sleep duration, Deep sleep duration, REM sleep duration, Light sleep duration, Awake time, Sleep efficiency, Restfulness, Sleep latency, Sleep timing, Deep sleep percentage, REM sleep percentage, and 87 more

Actions

Reconcile statisticsRe-import a recent window of Oura data into long-term statistics so late-arriving data backfills the correct dates.Fields: Days

From the README

Brings your Oura Ring data into Home Assistant: sleep, readiness, activity, heart rate, stress, workouts, and more, from Oura's v2 cloud API over OAuth2. History is imported into Home Assistant's long-term statistics, so charts are filled from day one.
Works with Gen 3, Ring 4, and Ring 5. Requires Home Assistant 2026.3.0 or newer.
99 sensors + 2 binary sensors: sleep, readiness, activity, heart rate and HRV, stress and resilience, SpO2, VO2 Max, cardiovascular age, workouts, mindfulness sessions, tags, rest mode, and ring…
History on first setup: imports 1-48 months (default 3) of past data as long-term statistics with the correct dates.
Late-data backfill: once a day re-imports the last 7 days (configurable) so data Oura syncs late lands on the right date.
Latest sleep tracking: Latest Bedtime Start/End follow the most recent session, naps included, for sleep-based automations.
Graceful degradation: features your ring or membership lacks simply stay unavailable instead of raising errors.
Multiple accounts: add one entry per Oura account.

From the README of louispires/Oura-Home-Assistant-Integration, MIT License. Shortened.