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.3.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. Each sensor shows the latest quarter-hour reading in kWh as its state.

EDA data is historical (T-1), not live. 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
  • A Refresh button triggers an immediate data fetch
  • The energiedaten.reimport service (Developer Tools → Services) re-fetches all historical data on demand
  • When the grid operator re-sends corrected readings, affected days are automatically re-fetched
  • 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