Octopus Energy French for Home Assistant (Marketplace integration)

Installs: 268 sharing analytics
GitHub stars: 23
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v4.1.13, October 25, 2026
Category: Energy, Energy prices
Kind: Marketplace integration
Brand: Octopus Energy
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: octopus_french
Source: github.com/domodom30/ha-octopus-french
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 French tracks electricity and gas consumption and costs from an Octopus Energy France account. It covers base, peak and off-peak, and Tempo contracts, and imports historical readings into the Energy dashboard. Further sensors report Linky meter index values, the pot balance and the latest electricity and gas invoices with payment status. For Intelligent Recharge, it adds switches for boost charge and smart control, plus a target charge number and a target time select. Data refreshes on a schedule through the vendor's cloud, and an action forces an immediate update. Other actions recompute statistics and purge orphan ones, and a repair notice flags incomplete off-peak hours on a Tempo contract. Setup is done in the UI with the account email and password.

Automatic summary of the README and code of domodom30/ha-octopus-french. 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

Switches
Sensors

Setting it up

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

Set up Octopus Energy France

EmailThe email address of your Octopus Energy France account
PasswordThe password of your Octopus Energy France account

Select an account

AccountThe Octopus Energy France account to link to this entry

Re-authenticate

PasswordThe current password of your Octopus Energy France account

Texts from the code of domodom30/ha-octopus-french.

Entities

Binary sensorsOff-peak hours active
NumbersTarget charge
SelectsTarget time
SensorsConsumption, Peak hours consumption, Off-peak hours consumption, Summer peak hours consumption, Summer off-peak hours consumption, Winter peak hours consumption, Winter off-peak hours consumption, Cost, Peak hours cost, Off-peak hours cost, Summer peak hours cost, Summer off-peak hours cost, and 50 more
SwitchesBoost charge, Smart control

Actions

Force updateForce an immediate data refresh from the Octopus Energy API
Recompute statisticsRe-fetches electricity readings from a given date and rewrites the matching statistics. Use after an update that fixes a consumption or cost calculation. Gas is unaffected: its readings are already re-fetched over a rolling year on every refresh.Fields: Start date, PRM
Purge orphan statisticsLists the statistic series no active meter can feed any more, for instance after a tariff change. Nothing is deleted without confirmation.Fields: Confirm deletion

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Incomplete off-peak hours on a Tempo contract