Connect Home Assistant

Works with all plans — including the free Community plan.

Home Assistant is an open-source smart home platform for technically minded users, smart home enthusiasts, and developers. The energiedaten.at HACS integration imports Smart Meter data directly into Home Assistant Long-Term Statistics — no separate broker or additional middleware required.

Beta: The integration is in beta (version 0.2.x). Features and configuration details may still change.

Prerequisites

  • energiedaten.at account (Community plan or higher)
  • At least one connected meter with data
  • Home Assistant 2025.12.0 or later
  • HACS installed
  • API token with meters:read and data:read permissions — create one under Profile → API Tokens

Installation

  1. Open HACS → three-dot menu → Custom Repositories
  2. Enter the URL: https://github.com/energiedaten-at/ha-energiedaten, category: Integration
  3. Search for "energiedaten.at" and install
  4. Restart Home Assistant
  5. Go to Settings → Integrations → Add Integration → search for "energiedaten.at"
  6. Enter your API token and team slug (find the team slug in the URL: energiedaten.at/app/{team-slug}/)
  7. Select your meters — sensors are created automatically per meter and energy direction

Setting Up the Energy Dashboard

  1. Open Settings → Dashboards → Energy
  2. Add consumption sensors under Grid consumption
  3. Add feed-in sensors under Return to grid

Data appears with correct historical timestamps — not at the time of import. The Energy Dashboard will therefore show a complete consumption history from the first available reading.

Checking the Connection

Open Developer Tools → States and search for sensors with the prefix sensor. followed by the meter label.

The sensors do not show a live real-time state — data is imported historically and appears exclusively in the Energy Dashboard. After initial setup, the first data can take up to 24 hours to appear, depending on the grid operator's EDA delivery schedule.

Notes

  • The integration polls incrementally for new data every 6 hours
  • For meters in an energy community, multiple sensors per meter may be created (different OBIS codes)
  • Source code and issues: github.com/energiedaten-at/ha-energiedaten