Skip to content

Repository files navigation

Lekkerladen for Home Assistant

hacs_badge GitHub release HA License: MIT

Unofficial custom integration for Lekkerladen — Dutch ERE compensation for home EV charging. It logs in the same way as the Lekkerladen app: your email, then a 6-digit code from the inbox.

Not affiliated with Lekkerladen. Reverse-engineered from the public web app. Use at your own risk.

Built with agentic coding using Grok 4.6 (xAI).

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Install with HACS (recommended)

  1. Install HACS if you do not have it yet.
  2. Click the badge above, or in Home Assistant: HACS → Integrations → ⋮ → Custom repositories
    • Repository: https://github.com/fclage/FCL.HA.Lekkerladen
    • Type: Integration
  3. Find Lekkerladen in HACS and download it.
  4. Restart Home Assistant.
  5. Settings → Devices & services → Add integration → Lekkerladen

Manual install

Copy custom_components/lekkerladen into your Home Assistant config:

<config>/custom_components/lekkerladen/

Restart Home Assistant, then add the integration from the UI.

Setup

  1. Enter the email address of your Lekkerladen account.
  2. Wait for the 6-digit login code (same mail as app.lekkerladen.com/inloggen).
  3. Paste the code. Home Assistant stores the session token, not the code.

The Lekkerladen session lasts about 7 days. When it expires, Home Assistant asks you to re-authenticate (new email code).

What you get

Polled every 15 minutes from api.lekkerladen.com:

Entity Meaning
Month / year energy kWh of certified home sessions
Month / year sessions Session counts
ERE price Live € per ERE
ERE per kWh Gross €/kWh from Lekkerladen
Net per kWh Gross €/kWh after Lekkerladen commission
Month / year estimated payout Energy × net €/kWh (estimate, not a bank payout)
Contract active / expires Current mandate
Provider last fetched / token valid Linked charger-provider OAuth (e.g. Tesla)
Login session expires When you need a new email code
Per charger Latest session energy + timestamps, serial, MID certified

Payout sensors are estimates from the published rate. Actual settlement follows Lekkerladen’s trading calendar.

Requirements

  • Home Assistant 2024.12 or newer (tested against 2026.8)
  • A Lekkerladen account
  • Internet access from the Home Assistant host to app.lekkerladen.com and api.lekkerladen.com

No extra Python packages. The integration uses aiohttp, which ships with Home Assistant.

Snapshots

image

Privacy

Diagnostics redact the session token, email, EAN, phone, and address. Do not commit tokens or OTP codes.

Development

python -m unittest discover -s tests -v

Bump the integration version on every user-facing change (see CONTRIBUTING.md):

python scripts/bump_version.py 0.1.1

API notes: docs/api.md.

License

MIT

About

Unofficial Home Assistant integration for Lekkerladen (Dutch ERE / home EV charging compensation)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages