--- title: "Octopus Energy" description: "Octopus Energy is a Marketplace integration for Home Assistant. It has 10.5k installs sharing analytics, needs the vendor's cloud and was last updated October 18, 2026." canonical: "https://vulpo.app/integrations/marketplace/bottlecapdave-homeassistant-octopusenergy" url: "https://vulpo.app/integrations/marketplace/bottlecapdave-homeassistant-octopusenergy.md" last-updated: "2026-10-22" version: "1.4" --- # Octopus Energy > Octopus Energy is a Marketplace integration for Home Assistant. It has 10.5k installs sharing analytics, needs the vendor's cloud and was last updated October 18, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=BottlecapDave&repository=HomeAssistant-OctopusEnergy&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=BottlecapDave&repository=HomeAssistant-OctopusEnergy&category=integration) ## 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. ## 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 key**: This 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 dispatches**: Dispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information. - **Intelligent tariff rate mode**: Determines how rates should be adjusted when dispatches are found outside of normal off peak periods - **Minimum required minutes for planned dispatches**: This 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 sensor**: If 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 key**: This 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 dispatches**: Dispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information. - **Intelligent tariff rate mode**: Determines how rates should be adjusted when dispatches are found outside of normal off peak periods - **Minimum required minutes for planned dispatches**: This will impact dispatch sensors and adjusted rate information - **Enforce intelligent cap**: This 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](https://github.com/BottlecapDave/HomeAssistant-OctopusEnergy). ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices 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](https://github.com/BottlecapDave/HomeAssistant-OctopusEnergy#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Energy prices - Brand: [Octopus Energy](https://vulpo.app/integrations/octopus-energy.md) - Number: 10.5k installs sharing analytics; 1k GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v19.2.1, last updated October 18, 2026 - Domain: `octopus_energy` - Source: - Issues: In Vulpo: Quick Toggle card, Climate card, Select card, Calendar card, Apple Watch, Control Center, Climate Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for Octopus Energy | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Octopus Germany](https://vulpo.app/integrations/marketplace/thecem-octopus-germany.md) | Marketplace integration | 875 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Octopus Energy Italy](https://vulpo.app/integrations/marketplace/samuelebistoletti-homeassistant-octopusenergyit.md) | Marketplace integration | 419 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Octopus Energy French](https://vulpo.app/integrations/marketplace/domodom30-ha-octopus-french.md) | Marketplace integration | 268 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Octopus Spain](https://vulpo.app/integrations/marketplace/miguelangellv-ha-octopus-spain.md) | Marketplace integration | 254 installs sharing analytics | Works locally | Updated in the last 6 months | | [octopusagile](https://github.com/markgdev/home-assistant_OctopusAgile) | Marketplace integration | 21 installs sharing analytics | Needs the vendor's cloud | No update in over 18 months | 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/marketplace/bottlecapdave-homeassistant-octopusenergy --- - HTML version of this page: https://vulpo.app/integrations/marketplace/bottlecapdave-homeassistant-octopusenergy - 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