ESB Smart Meter for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 52 sharing analytics
GitHub stars: 2
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v0.6.3, November 9, 2026
Category: Energy, Meters and monitoring
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: esb_smart_meter
Source: github.com/gerbear1990/ha-esb-smart-meter
Issues: Report an issue

Shows 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

ESB Smart Meter is a custom integration that turns ESB Networks smart meter CSV exports into Home Assistant sensors. It reads interval CSV files from a local folder, removes duplicate readings by timestamp, and reports energy usage, itemised cost, tariff bands and import health. Tariff window times, unit rates, standing charge, VAT, supplier discount and an export rate for solar can all be configured, and cost is split into energy, standing charge, discount and VAT lines. Past CSV history is backfilled into long-term statistics so it appears on the Energy dashboard, and an action can also prune old readings into a single CSV. Other actions rescan the folder or download the latest CSV from the ESB Networks portal when credentials and a meter number are set. Repair notices appear when no data is found or readings stop updating, and setup is done in the UI.

Automatic summary of the README and code of gerbear1990/ha-esb-smart-meter. Something wrong, or are you the maintainer and want your own text here? Get in touch

Shows in Vulpo

Chart card, Apple Watch.

Download Vulpo

Installs over time

Oct 21Nov 14

#1,539 of 1,584 Marketplace integrations. Installs sharing analytics.

Supports

Works locallyTalks to your devices on your own network. No vendor cloud in between.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

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

ESB Smart Meter

Name
CSV import path
Time shift in minutes
Cheap/boost rate start time
Cheap/boost rate end time
Night rate start time
Day rate start time
Peak rate start time
Peak rate end time
Currency
Daily standing charge
Export / feed-in rate (per kWh)
VAT rate (%, e.g. 9)
Supplier discount (%, e.g. 16)
Cheap rate

After setup

CSV import path
Time shift in minutes
Cheap/boost rate start time
Cheap/boost rate end time
Night rate start time
Day rate start time
Peak rate start time
Peak rate end time
Currency
Daily standing charge
Export / feed-in rate (per kWh)
VAT rate (%, e.g. 9)
Supplier discount (%, e.g. 16)
Cheap rate
Night rate

Texts from the code of gerbear1990/ha-esb-smart-meter.

Entities

SensorsLast import, Last reading, Last reading age, Records, Coverage days, Latest interval energy, Total import, Current rate bucket, Current rate, Today energy, Today cheap energy, Today night energy, and 40 more

Actions

Reload ESB smart meter dataRe-scan the configured ESB CSV folder and update all ESB Smart Meter sensors.
Download from ESB NetworksLog in to the ESB Networks portal and download the latest interval CSV, then refresh sensors. Requires portal credentials and MPRN to be configured.
Import history into statisticsBackfill available CSV history into long-term statistics so past usage and cost appear on the Energy dashboard. This also runs automatically after each refresh.
- Rebuild from scratch
Prune old readingsConsolidate the import folder into a single tidy CSV, keeping only the most recent days. Originals are moved to a backup subfolder.
- Keep days

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:No ESB smart meter data found, ESB smart meter data has stopped updating

From the README

A Home Assistant custom integration for ESB Networks smart meter CSV exports. It reads interval CSV files from a local folder and turns them into sensors for energy usage, itemised cost, tariff bands, and import health — and backfills your history onto the Energy dashboard.
This integration does not create or manage your ESB Networks account. It is for people who can already access their ESB Networks smart meter data and want to turn those CSV exports into Home Assistant sensors.
Imports ESB interval CSV files from a configured Home Assistant folder, deduplicating readings by timestamp when multiple files overlap.
Tracks total imported kWh, today's, yesterday's and this month's usage, the most recent complete day, and a 7-day rolling average.
Fully configurable tariff bands — the cheap/boost, night, day, and peak window times are set to match your supplier plan.
Itemised cost — energy, standing charge, discount, and VAT are each reported as their own line, so any total can be checked against a real bill.
Configurable VAT and supplier discount, applied in the order a supplier applies them.
Energy dashboard backfill — your CSV history is imported into long-term statistics automatically, and stays continuous across pruning.
Solar export / microgeneration support, including feed-in earnings.
Optional ESB Networks portal download — enter your account details and Home Assistant can fetch the CSV for you.

From the README of gerbear1990/ha-esb-smart-meter, MIT License. Shortened.