Octopus Energy for Home Assistant (Marketplace integration)

Installs: 10.5k sharing analytics
GitHub stars: 1k
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v19.2.1, October 18, 2026
Category: Energy, Energy prices
Kind: Marketplace integration
Brand: Octopus Energy
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: octopus_energy
Source: github.com/BottlecapDave/HomeAssistant-OctopusEnergy
Issues: Report an issue

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

About

Octopus Energy is an unofficial integration that brings Octopus Energy account data into Home Assistant. It is built against the Octopus Energy UK API and has not been tested for other countries. It supports electricity and gas meters, covering consumption data and rate information, and it relies on the vendor's cloud. Entities span many platforms, including sensors, binary sensors, calendars, climate, events, switches and water heaters. Account options cover gas calorific value, preferring direct debit rates, Home Mini and Home Pro refresh settings, price caps and intelligent tariff handling. Cost trackers and tariff comparisons can be added as extra entries, and it is set up in the UI.

Automatic summary of the README and code of BottlecapDave/HomeAssistant-OctopusEnergy. 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.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Climate
Water heaters
Switches
Sensors
Calendars

Setting it up

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

Octopus Energy Account

Account ID (e.g. A-AAAA1111)
Api key
Gas calorific value.This can be found on your gas statement and can change from time to time
Favour direct debit rates where available
Automatically discover sensors suitable for cost trackers
I have a Home Mini
Home Mini electricity refresh rate in minutes
Home Mini gas refresh rate in minutes
Home Pro address (e.g. http://192.168.0.1)
Home Pro API keyThis is only required if you have setup the custom API.
Optional electricity price cap in pence
Optional gas price cap in pence
Manually refresh intelligent dispatchesDispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information.
Intelligent tariff rate modeDetermines how rates should be adjusted when dispatches are found outside of normal off peak periods
Minimum required minutes for planned dispatchesThis will impact dispatch sensors and adjusted rate information

Octopus Energy Cost Tracker

The name of your cost sensor
The meter the cost rates should be associated with
The entity to track the costs for.
Tracked entity state is accumulative
The day when the week cost sensor should reset
The day when the month cost sensor should reset
Don't automatically reset the cost sensorIf enabled, you will need to reset this sensor manually via the available service. You will also not get week and month sensors. This may produce Home Assistant warnings if not reset for long periods of time.

Also asked when changing the connection.

Octopus Energy Cost Tracker

Account

Also asked when at the octopus energy tariff comparison step.

Octopus Energy Tariff Comparison

The name of your tariff comparison
The meter of the data that should be compared to
The product code of the tariff to compare.
The tariff code of the tariff to compare.

Also asked when changing the connection.

Update Account Info

Api key
Gas calorific value.This can be found on your gas statement and can change from time to time
Favour direct debit rates where available
Automatically discover sensors suitable for cost trackers
I have a Home Mini
Home Mini electricity refresh rate in minutes
Home Mini gas refresh rate in minutes
Home Pro address (e.g. http://192.168.0.1)
Home Pro API keyThis is only required if you have setup the custom API.
Optional electricity price cap in pence
Optional gas price cap in pence
Manually refresh intelligent dispatchesDispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information.
Intelligent tariff rate modeDetermines how rates should be adjusted when dispatches are found outside of normal off peak periods
Minimum required minutes for planned dispatchesThis will impact dispatch sensors and adjusted rate information
Enforce intelligent capThis is an artificial cap with the integration and is separate from the cap within the app. If enabled, the 6 hour intelligent cap will be enforced when adjusting rates. See docs for more information.

Texts from the code of BottlecapDave/HomeAssistant-OctopusEnergy.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Cost override has been deprecated, Proposal: The removal of target rate sensors from the integration, Target rate configuration not supported, Saving session and free electricity sensors naming change

From the README

Custom component built from the ground up to bring your Octopus Energy details into Home Assistant to help you towards a more energy efficient (and or cheaper) home. This integration is built against the API provided by Octopus Energy UK and has not been tested for any other countries.
This integration is in no way affiliated with Octopus Energy.
Electricity and gas meter support including consumption data and rate information

From the README of BottlecapDave/HomeAssistant-OctopusEnergy, MIT License. Shortened.