Your utility's energy data, in Home Assistant

Open Green Button bridges your power company's Green Button (NAESB ESPI) data feed into your Home Assistant Energy dashboard. Stateless, open source, and your data never lives on our server. Each utility generally requires signing up as a Green Button third-party data consumer. With Open Green Button, the Home Assistant community can do this just once for each utility.

How it works

1

Install the integration

Add the Open Green Button custom component to your Home Assistant install via HACS.

2

Authorize your utility

Click through your utility's standard Green Button login. We never see your utility password — the OAuth handshake stays between you and your power company.

3

See your usage

Hourly consumption flows into Home Assistant's Energy dashboard automatically, keeping itself up to date in the background.

Privacy is built in

Supported utilities

Burlington Hydro
Connect
Kentucky Utilities
Connect
Milton Hydro (SANDBOX for testing only)
Connect

Want your utility added? Open an issue on GitHub — adding a new utility is a config change once they've approved the app.

Get started

Three steps, one-time setup:

  1. Install via HACS. In Home Assistant, open HACS → ⋮ → Custom repositories and add rocketraman/open-green-button-homeassistant as an Integration. Then search Open Green Button → Install. Restart Home Assistant when prompted.
  2. Add the integration. Settings → Devices & Services → Add Integration → Open Green Button. Pick your utility from the list.
  3. Authorize and paste back. Click the authorization link, sign in at your utility's Green Button page, copy the claim code shown after consent, and paste it back into Home Assistant.

That's it — your energy data appears in the Energy dashboard within a few minutes and continues updating automatically.

Support the project

Open Green Button is free to use. If it saves you time or you'd like to help keep it maintained and hosted (there's a small Fly.io bill and ongoing time spent adding new utilities and keeping up with Home Assistant changes), donations are welcome.

Suggested: $5 / month — roughly enough to cover hosting plus a contribution toward maintenance time. Anything above that funds new features and utility integrations and keeps me caffeinated.