EDF Energy (UK) for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 131 sharing analytics
GitHub stars: 54
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: 21.0.4, November 5, 2026
Category: Energy, Meters and monitoring
Kind: Marketplace integration
Brand: EDF
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: edfenergy_uk
Source: github.com/stevekirtley/HomeAssistant-EDFEnergy
Issues: Report an issue

Shows in Vulpo Quick Toggle card, Button card, Select card, Calendar card, Apple Watch, Control Center.

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

About

EDF Energy (UK) is an unofficial integration that connects Home Assistant to an EDF Energy UK account through the vendor's cloud. It is a fork of an Octopus Energy integration, adapted for EDF's Kraken platform. It adds current, previous and next rate sensors for electricity and gas, along with standing charges and previous consumption and cost by day, week and month. Cost tracker sensors can follow the cost of any energy-based entity, and tariff comparison sensors compare against another tariff. Smart charging for EV dispatches brings sensors, switches and controls such as charge target and ready-by time, and long-term statistics feed the energy dashboard. Options cover free electricity session feeds, price caps and a tabbed dashboard panel, and setup is done in the UI with account details.

Automatic summary of the README and code of stevekirtley/HomeAssistant-EDFEnergy. Something wrong, or are you the maintainer and want your own text here? Get in touch

Shows in Vulpo

Quick Toggle card, Button card, Select card, Calendar card, Apple Watch, Control Center.

Download Vulpo

Supports

Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Switches
Sensors
Calendars

Setting it up

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

EDF Energy Account

Account ID (e.g. A-AAAA1111)Your account ID can be found on your bill or in your EDF Energy online account
Email addressYour EDF Energy account email address. Leave the email and password blank if you are providing an API key directly.
PasswordYour password is used only once to obtain an API key and is never stored.
API key (optional)Optional. If you already have an EDF API key, paste it here and leave the email and password blank. Otherwise leave this empty and a key will be generated from your email and password.
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
Automatically enrol in Sunday SaverCurrently inactive. Sunday Saver was retired and replaced by Flextras, which can only be joined in the EDF mobile app, so HA no longer auto-enrols. This setting is retained for a future scheme.
Use the Power Perks session feedEDF announce Power Perks free electricity sessions by text message only, so they are relayed through a small feed that publishes the times. The integration checks it every 15 minutes and sends nothing but its own version number - no account details. Leave it on to have sessions appear automatically, or turn it off to stop the checks; you can still add sessions yourself with the Register Power Perks session action.
Optional electricity price cap in pence
Optional gas price cap in pence
Manually refresh smart charging dispatchesDispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information.
Smart charging 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
Days of dispatch history to keepHow long to keep the record of what dispatches were known at each point in time, used by the point in time dispatch history action. Lower values use less disk and memory.

EDF 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 manually reset this sensor 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 times.

Also asked when changing the connection.

EDF Energy Cost Tracker

Account

Also asked when at the edf energy tariff comparison step.

EDF 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.

Re-authenticate EDF Energy Account

Email address
PasswordYour password is used only once to obtain a new API key and is never stored.
API key (optional)Optional. Paste an existing EDF API key instead of signing in with your email and password.

Update Account Info

Email addressYour EDF Energy account email address. Leave the email and password blank if you are providing an API key directly.
PasswordEntering your password generates a fresh API key. It is used only once and never stored.
API key (optional)Optional. Paste an existing EDF API key, or leave blank and enter your email and password to generate one.
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
Automatically enrol in Sunday SaverCurrently inactive. Sunday Saver was retired and replaced by Flextras, which can only be joined in the EDF mobile app, so HA no longer auto-enrols. This setting is retained for a future scheme.
Use the Power Perks session feedEDF announce Power Perks free electricity sessions by text message only, so they are relayed through a small feed that publishes the times. The integration checks it every 15 minutes and sends nothing but its own version number - no account details. Leave it on to have sessions appear automatically, or turn it off to stop the checks; you can still add sessions yourself with the Register Power Perks session action.
Optional electricity price cap in pence
Optional gas price cap in pence
Manually refresh smart charging dispatchesDispatches will not automatically refresh, but instead only refresh when an exposed service/action is called. See docs for more information.
Smart charging 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
Days of dispatch history to keepHow long to keep the record of what dispatches were known at each point in time, used by the point in time dispatch history action. Lower values use less disk and memory.

After setup

Show the dashboard tabs (beta)Splits the EDF Energy panel into tabs - Overview, Charging, Usage, Perks and Account - instead of the single screen. The Overview tab is the page you already know and nothing has been taken off it. Still in beta, so the layout may change between releases. On by default; turn it off to go back to the single screen. You can also switch this from the bottom of the panel's Overview.
Include World Cup 2026 free electricity sessions (England & Scotland matches)When enabled, free electricity windows are added to the session feed for every England or Scotland World Cup match (2 hours from kick-off). Only enable this if your account is enrolled in EDF's World Cup free electricity offer.
Automatically enrol in Sunday SaverCurrently inactive. Sunday Saver was retired and replaced by Flextras, which can only be joined in the EDF mobile app, so HA no longer auto-enrols. This setting is retained for a future scheme.
Use the Power Perks session feedEDF announce Power Perks free electricity sessions by text message only, so they are relayed through a small feed that publishes the times. The integration checks it every 15 minutes and sends nothing but its own version number - no account details. Leave it on to have sessions appear automatically, or turn it off to stop the checks; you can still add sessions yourself with the Register Power Perks session action.

Texts from the code of stevekirtley/HomeAssistant-EDFEnergy.

Entities

EventsFree Electricity Session Events

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, Free electricity event history is using a lot of database space, EDF Energy: API key needed, The old EDF Energy folder can be deleted, Another EDF integration has the same account set up

From the README

Electricity current, previous, and next rate sensors
Gas current, previous, and next rate sensors
Electricity and gas standing charge sensors
Previous consumption and cost (daily, weekly, monthly)
Cost tracker sensors (track cost of any energy-based entity)
Tariff comparison sensors
Smart Charging (EV dispatch) sensors, switches, and controls — including charge target %, ready-by time, and smart charge toggle
Long-term statistics for HA energy dashboard

From the README of stevekirtley/HomeAssistant-EDFEnergy, MIT License. Shortened.