---
title: "OSO Energy"
description: "OSO Energy is a built-in integration for Home Assistant. It has 75 installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/osoenergy"
url: "https://vulpo.app/integrations/core/osoenergy.md"
last-updated: "2026-10-22"
version: "1.4"
---

# OSO Energy

> OSO Energy is a built-in integration for Home Assistant. It has 75 installs sharing analytics and needs the vendor's cloud.

OSO Energy is a built-in integration that connects OSO Energy water heaters to Home Assistant through the vendor's cloud. It adds a water heater entity along with sensors for water temperatures at different tank levels, heater mode, optimization mode, and the amount of mixed water available at 40°C. Binary sensors report whether the heater is heating, in power save, or using extra energy. Actions can read and set the heater temperature profile, set the minimum quantity of water at 40°C, and turn on away mode. Heating can also be turned on or off for one hour, or until the maximum or minimum temperature is reached. Setup happens in the UI and asks for an API key.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=osoenergy)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### OSO Energy auth

- **API key**

Also asked when signing in again.

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Binary sensors**: Extra energy, Heating, Power save
- **Sensors**: Capacity mixed water 40°C, Heater mode, Optimization mode, Profile local, Tapping capacity, Temperature bottom, Temperature middle, Temperature one, Temperature top, Maximum level of mixed water at 40°C, Minimum level of mixed water at 40°C, Mixed water at 40°C

## Actions

- **Get heater profile**: Gets the temperature profile for water heater
- **Set heater profile**: Sets the temperature profile for water heater
  Fields: 00:00, 01:00, 02:00, 03:00, 04:00, 05:00, 06:00, 07:00, 08:00, 09:00
- **Set v40 min**: Sets the minimum quantity of water at 40°C for a heater
  Fields: V40 Min
- **Set away mode**: Turns on away mode for the water heater
  Fields: Duration in days
- **Turn off heating**: Turns off heating for one hour or until min temperature is reached
  Fields: Until temperature limit
- **Turn on heating**: Turns on heating for one hour or until max temperature is reached
  Fields: Until temperature limit

## At a glance

- Kind: Built-in integration
- Category: [Energy](https://vulpo.app/integrations/category/energy.md), Meters and monitoring
- Number: 75 installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `osoenergy`
- Source: <https://www.home-assistant.io/integrations/osoenergy/>

In Vulpo: Chart card, Apple Watch

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/osoenergy

---

- HTML version of this page: https://vulpo.app/integrations/core/osoenergy
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml