An open-source Green Button (NAESB ESPI) third-party application that bridges utility energy data into Home Assistant.
The hosted server is a stateless OAuth proxy: utilities require a stable public callback URL, but your data never lives on our server. Refresh tokens are stored encrypted on your Home Assistant instance, and every request flows through the proxy carrying the token from your side.
- ✅ Live! Alectra (Ontario, Canada).
- ✅ Live! Burlington Hydro (Ontario, Canada).
- ✅ Live! Consumers Energy (Michigan, USA), thank you Michael Phillippi (@philliml74).
- ✅ Live! Elexicon Energy (Ontario, Canada), thank you Muhammad Aziz (@rabbitholelabsinc).
- ✅ Live! Elk Energy (Ontario, Canada).
- ✅ Live! Enwin (Ontario, Canada).
- ✅ Live! Festival Hydro (Ontario, Canada).
- ✅ Live! Hydro Ottawa (Ontario, Canada), thank you Mike Wrightly (@mikewrightly).
- ✅ Live! Kentucky Utilities (Kentucky, USA), thank you Tag Howard (@jthoward64).
- ✅ Live! London Hydro (Ontario, Canada).
- ✅ Live! Milton Hydro (Ontario, Canada), thank you Jeff Aycan (@JAudi23).
- ✅ Live! Newmarket-Tay (NT) Power (Ontario, Canada).
- ✅ Live! Niagara Peninsula Energy (Ontario, Canada).
- ✅ Live! Oakville Hydro (Ontario, Canada).
- ✅ Live! Oshawa Power (Ontario, Canada).
- 🚧 Registration in progress Pacific Gas & Electric (California).
Request a new utility here:
https://github.com/rocketraman/open-green-button/issues/new?template=new-utility-request.md
server/— Kotlin/Ktor proxy server (deployed to Fly.io with scale-to-zero)docs/— Architecture, deployment, per-utility notesbranding/— Logo and brand assets
The Home Assistant custom integration lives in its own repository so HACS validation finds the canonical custom_components/ + hacs.json layout at the repo root: rocketraman/open-green-button-homeassistant.
The hosted server holds no per-user durable state. Per-utility OAuth client credentials are configured globally; every other piece of state (your refresh token, your usage data) lives only on your Home Assistant instance.
Discuss the add-on, ask questions, and share feedback on the Home Assistant community forum:
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 utility integrations.