My Polenergia — HACS Custom Integration

Share your Projects! Custom Integrations
, ,
1

Custom integration for customers of Polenergia Dystrybucja that pulls monthly meter readings from the moja.polenergia.pl portal API (OAuth2 + PKCE) and feeds them into the Home Assistant Energy Dashboard with optional cost tracking in PLN.

Features:

  • :satellite_antenna: OAuth2 + PKCE authentication — no scraping, secure token flow against the official portal API.

  • :bar_chart: Energy Dashboard ready — cumulative monthly kWh statistics fed straight into the HA recorder.

  • :file_cabinet: Full historical import — pulls every monthly reading back to your agreement start date.

  • :money_bag: Cost calculation — configure a PLN/kWh price, get a cumulative cost statistics sensor for Energy Dashboard cost tracking.

  • :house: Multi-meter support — one HA device per measurement point (PPE), per customer account.

  • :repeat_button: Auto re-authentication — handles token expiry without user intervention.

  • :hammer_and_wrench: Options menu — set price, change credentials, reload history, clear statistics, all from the UI.

Installation

HACS (custom repository)

  1. Open HACS → Integrations → ⋮ → Custom repositories.

  2. Add https://github.com/Nigatsu/hass-my-polenergia as category Integration.

  3. Find My Polenergia in the list and click Install.

  4. Restart Home Assistant.

Manual

  1. Download the latest release from Releases.

  2. Copy custom_components/my_polenergia/ to your config/custom_components/ directory.

  3. Restart Home Assistant.

Links

Feedback, bug reports, and feature requests are welcome!