Note: This fork is a continuation of unmaintained librelink integration by @gillesvs
Connect your Abbott FreeStyle LibreLink continuous glucose monitor (CGM) data into Home Assistant, straight from your LibreLinkUp account — no extra hardware, no scraping required.
For every patient linked to your LibreLinkUp account, this integration creates a full set of sensors with an enhanced, trend calculation that's more responsive than the sensor's native trend readout.
- 📈 Enhanced trend calculation — More accurate than the sensor's native trend. Uses a weighted average across multiple time windows (1-min, 5-min, 15-min) with smoothing logic to reduce noise and better reflect true physiological changes, instead of relying on the sensor's raw native trend.
- 🎯 Time In Range (24h) — Rolling 24-hour percentage of readings within your target range, persisted across Home Assistant restarts.
- 🩸 Per-patient sensors — automatically sets up entities for every patient linked to your LibreLinkUp account.
- ⏳ Sensor expiry — shows when the current sensor was applied and when it expires.
⚠️ High/low binary sensors — instantly know when glucose is out of range.- 🖥️ Configured entirely through the Home Assistant UI — no YAML required to get started.
- 🔁 Session-based authentication — token retrieved automatically for the duration of the Home Assistant session.
- 🌍 Multi language support — English, German, French, Slovak, Polish.
| Sensor | Description |
|---|---|
| Measurement | Latest glucose reading, updated every minute, in the unit chosen during setup (mg/dL or mmol/L). |
| Time In Range (24h) | Percentage of readings within your target range over a rolling 24-hour window. Survives Home Assistant restarts by rebuilding from recorder history. |
| Trend | Direction and speed of glucose change, classified using clinical thresholds. |
| Glucose Trend Arrow | Visual arrow indicator: ↑ ↗ → ↘ ↓ |
| Rate of Change | Precise speed of change, in mg/dL/min or mmol/L/min. |
| Delta 1min / Delta 5min / Delta 15min | Absolute change in glucose over the last 1, 5, and 15 minutes (mg/dL or mmol/L). Needs a few minutes of history after a restart. |
| Application Timestamp | When the current sensor was activated. Attributes show the serial number and the sensor lifetime in use. |
| Expiration Timestamp | When the current sensor expires: activation time plus the sensor lifetime. |
| Last Measurement Timestamp | Time of the latest reading received from LibreLinkUp. |
| Sensor | Description |
|---|---|
| Is High | true when glucose is above the configured high threshold. |
| Is Low | true when glucose is below the configured low threshold. |
You can visualize glucose trends with a
mini-graph-card:
See the full example here: mini-graph-glucose.yml
or you can use LibreLink Extended Card
Via HACS (recommended)
- Add this repository
https://github.com/dodog/librelinkin HACS - Click download on bottom right corner and install it.
- Restart Home Assistant.
- Copy the
custom_components/librelinkfolder from this repository into your Home Assistantcustom_componentsdirectory. - Restart Home Assistant.
Configuration is done entirely from the Home Assistant UI:
- Go to Settings → Devices & Services → Integrations.
- Click + Add Integration and search for Librelink.
- Enter the username (email) and password of your LibreLinkUp account, not Libreview, and select your region.
- Select the patient, the unit for glucose values, and the sensor lifetime (see below). You can also enter an optional display name: a nickname used in the integration's title instead of the patient's real name.
If an account has several patients, add the integration once per patient. A patient can only be added once.
Requirements:
- A valid LibreLinkUp account.
- You must have accepted the Abbott user agreement inside the LibreLinkUp mobile app before the integration can retrieve data.
An authentication token is retrieved automatically and remains valid for the duration of the Home Assistant session — no manual token management needed.
LibreLinkUp does not report when a sensor expires, so the integration calculates it: activation time + sensor lifetime. The lifetime cannot be read reliably from the data either.
You therefore choose the lifetime:
| Option | Meaning |
|---|---|
| Automatic (default) | Old behaviour - a guess from the reported sensor type: type 3 → 14 days, type 4 → 15 days. This can be wrong, for example a Libre 2 Plus would be shown as 14 days. |
| 14 days | Libre 2, Libre 3 |
| 15 days | Libre 2 Plus, Libre 3 Plus |
The choice is saved for that patient and applies to every new sensor you activate, so you only need to change it when you switch to a different sensor type. To change it later, open Settings → Devices & Services → LibreLink and click Configure on the patient's entry. The Expiration Timestamp updates immediately, no restart needed.
If LibreLinkUp rejects the saved login (for example because you changed your password), polling stops and Home Assistant shows a repair notice for the integration. Click Reconfigure on the entry and enter the new password. The entry reloads and keeps its entities and recorded history; trend and delta values need a few minutes to rebuild.
- Go to Settings → Devices & Services → LibreLink.
- Open the ⋮ menu of a patient's entry and choose Delete. Repeat for every patient.
- If you installed via HACS, you can then remove the integration in HACS and restart Home Assistant.
Deleting an entry removes its devices and entities from Home Assistant. Your LibreLinkUp account and your data at Abbott are not affected.
Contributions, bug reports, and feature requests are welcome! Please read the Contribution Guidelines before opening a pull request or issue.
Like this integration? Give it a ⭐ on GitHub. And if this integration helps you manage your (or a loved one's) diabetes data, consider supporting its development:
- ☕ Buy Me a Coffee
- 💛 Ko-fi
This project is forked from and built on the work of @gillesvs, @kubasaw and others
Distributed under the MIT License.
Disclaimer: This is an unofficial, community-maintained integration and is not affiliated with, endorsed by, or supported by Abbott. It is not a medical device and should not be used as the sole basis for diabetes management decisions. Always follow guidance from your healthcare provider and refer to your official LibreLinkUp/FreeStyle Libre app for critical readings.