This is an unofficial custom integration for Home Assistant that allows you to connect and control Liebherr smart devices via the Liebherr SmartHomeAPI using the simple pyliebherr library.
- Monitor current and target temperatures of your Liebherr refridgeratorss and freezers.
- Control device features such as BioFreshPlus, Hydrobreeze, AutoDoor, Presentation Lights, and Ice Makers.
or search for the Liebherr integration in HACS
- Download the latest release from the GitHub Releases page.
- Extract the downloaded archive.
- Copy the
custom_components/liebherrfolder to your Home Assistantcustom_componentsdirectory.- Example:
/config/custom_components/liebherr
- Example:
- Restart Home Assistant.
- In Home Assistant, navigate to Settings > Devices & Services.
- Click Add Integration.
- Search for "Liebherr" and select it.
- Enter your Liebherr HomeAPI API key. (see here, how to get the key)
- Complete the setup process.
- (Optional): Configure the polling interval and the entity type for Presentation Light (see below).
Once the integration is configured, your Liebherr devices will appear as entities in Home Assistant. You can:
- Monitor temperatures and other metrics.
- Control switches and settings via the Home Assistant UI or automations.
- Change the poll interval on the configuration
Controls will map to the following domains:
| Liebherr Control | Homeassistant Domain |
|---|---|
| Auto Door | Cover |
| Ice Maker, BioFreshPlus | Select |
| Presentation Light | Light or Number* |
| SuperCool, SuperFreeze, PartyMode, NightMode | Switch |
| HydroBreeze | Fan |
| Temperature | Climate |
image_url (Device) |
Image |
| Bottle Timer | Not available |
* In version ≥ 2025.12.5 the domain/type of control/entity created can be selected in the integration options.
Currently appliances added to your Liebherr account will not be automatically discovered. Once an appliance is connected to your Liebherr account (and accessible in the SmartHome app) manually reload the integration from the integration screen:
and click on "Reload" on the configuration menu:
Given rate limits imposed by Liebherr in the beta SmartDevice Home API the integration can only make a request to the device control API more often than every 30s.
Tip
A diagnostic sensor will be created for each device showing the last timestamp of the most recent poll but is disabled by default (as it will quickly fill up your database with state changes).
This version will calculate the polling interval based on the number of devices/appliances associated with your Liebherr account. Essentially the goal is to poll each device's controls every 30 seconds and is calculated thusly:
With a minimun poll interval of 30 seconds.
The polling interval can be adjusted manual (within some present limits) by changing the integration options.
- Ensure your Liebherr api key is correct.
- Check the Home Assistant logs for any errors related to the integration.
- Enable debug on the integration.
- Download and inspect the integration diagnotics.
- If there are many
HTTP 429 - Too many requeststry increasing the polling interval.
This is a rewrite of the great custom intergration orginally maintained by @bhuebschen from a fork created by @skatsavos. The original intergration stopped working in Oct 2025 and the orginal maintainer did not appear to be maintaining the project.
Warning
This was tested on a Liebherr Device lacking:
- AutoDoor
- Presentation Light (reported to be working as number entity and partially as a light entity)
- BioFreshPlus (reported to be working)
- HydroBreeze (reported to be working)
If you encounter an issue with these features please submit an issue.
If you encounter any issues or have feature requests, please open an issue on the GitHub Issues page.
Contributions are welcome! Feel free to submit pull requests to improve this integration.
This project is licensed under the MIT License. See the LICENSE file for details.