Language / Sprache: English | Deutsch
This custom component integrates Octopus Germany services with Home Assistant, providing access to your energy account data, electricity prices, device control, and vehicle charging preferences.
This integration is in no way affiliated with Octopus Energy.
💚 Support the Project
⚡ New to Octopus Energy Germany?
- Account Information: Electricity and gas balance tracking across multiple accounts
- Energy Pricing: Real-time electricity tariff prices with support for:
- Simple tariffs (fixed rate)
- Time of Use tariffs (GO, STANDARD rates)
- Dynamic tariffs (with real-time pricing using unit rate forecasts)
- Heat tariffs (for heat pumps)
- Multi-Ledger Support: Electricity, Gas, Heat, and other ledger types
- Device Control: Smart charging control for electric vehicles and charge points
- Boost Charging: Instant charge boost functionality (requires smart charging enabled)
- Intelligent Dispatching: Real-time status of Octopus Intelligent charge scheduling
- Smart Charging Sessions: Track smart charges for Octopus rewards (30€/month with ≥5 charges)
- Smart Meter Readings: Previous day accumulative consumption with hourly breakdown (from Octopus-stored meter data)
- Octopus Historical Data Readout: Read historical consumption and meter readings stored by Octopus
- Service Device Grouping: All entities organized under single service device per account
- Multi-Account: Support for multiple Octopus accounts under one integration
- Multi-Device: Support for multiple Devices (EV, charger, heatpumps) under multiple accounts
- Gas infrastructure monitoring (MALO/MELO numbers, meters, readings)
- Latest Electricity meter reading
- Gas contract tracking with expiry countdown
- octopus-energy-rates-card compatibility for dynamic tariff visualization
- Add this repository as a custom repository in HACS
- Search for "Octopus Germany" in the HACS integrations
- Install the integration
- Restart Home Assistant
- Add the integration via the UI under Settings > Devices & Services > Add Integration
- Copy the
octopus_germanydirectory to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Add the integration via the UI under Settings > Devices & Services > Add Integration
The integration is configured via the Home Assistant UI:
- Navigate to Settings > Devices & Services
- Click + ADD INTEGRATION and search for "Octopus Germany"
- Enter your Octopus Energy Germany email and password
- The integration will automatically fetch your account number and set up the entities
To keep this start page compact, detailed documentation is split across focused pages:
- Full entities and attributes:
- Actions, switches and services with practical examples:
switch.octopus_<account_number>_<device_name>_smart_control- ON: smart control enabled
- OFF: smart control suspended
switch.octopus_germany_<account_number>_<device_name>_boost_charge- Starts/stops immediate boost charging (if available)
octopus_germany.set_device_preferences- Set target SoC (%) and target time for a specific device
octopus_germany.get_smart_meter_readings- Fetch historical iMSys readings for one day
octopus_germany.export_smart_meter_csv- Export iMSys readings to CSV (month/year)
octopus_germany.submit_meter_readings- Submit electricity or gas meter readings to the OE API
- Daily upload automation example
Wenn du Zählerdaten direkt über die HAN-Schnittstelle deines iMSys (SMGW) einlesen willst, kannst du diese Integration parallel nutzen:
Empfehlung:
octopus_germanyfür Vertrags-/Tarif-/Account- und SmartFlex-Daten sowie das Auslesen der bei Octopus gespeicherten historischen Verbrauchs-/Zählerdatenha-ppc-smgw-hanfür lokale, direkte HAN-Messwerte vom Gateway
Octopus Intelligent Go mit EVCC
If you encounter issues, you can enable debug logging by adding the following to your configuration.yaml:
logger:
logs:
custom_components.octopus_germany: debug
custom_components.octopus_germany.octopus_germany: debug
custom_components.octopus_germany.switch: debug- Cause: Smart charging is not enabled or device doesn't support boost charging
- Solution:
- Ensure the Smart Charging Control switch is turned ON
- Check that your device supports smart control (appears in device attributes)
- Verify device is in LIVE status and not suspended
- Cause: API token has expired or login credentials are invalid
- Solution: The integration automatically handles token refresh. If issues persist, try reloading the integration or re-entering credentials
- Cause: No smart-capable devices connected to your Octopus account
- Solution: Ensure your electric vehicle or charge point is properly connected to Octopus Intelligent
When reporting issues, please include:
- Home Assistant version
- Integration version
- Debug logs with sensitive information removed
- Device type and model (if applicable)
If you need more information for API debug set in const:
/config/custom_components/octopus_germany/const.py
LOG_API_RESPONSES = TrueAfter restarting HA the API-Responses and additional information will be in debug log.
For API-related questions, consult the official documentation:
- REST API: https://developer.oeg-kraken.energy/
- GraphQL API: https://developer.oeg-kraken.energy/graphql/
For bug reports and feature requests, please open an issue on the GitHub repository. Before raising anything, please read through the discussion. If you have found a bug or have a feature request please raise it using the appropriate report template.
https://deepwiki.com/thecem/octopus_germany
This integration is developed and maintained in my free time. If you find it valuable and want to support its continued development, consider:
Your support helps cover development time, testing infrastructure, and keeps the project actively maintained with new features and bug fixes.
- Contributing: Pull requests are welcome! Whether it's bug fixes, new features, or documentation improvements
- New to Octopus Energy?: Get 100€ bonus with my referral link when signing up
- Found a bug or have an idea?: Check the discussions or open an issue
Every contribution, whether code, feedback, or financial support, helps make this integration better for everyone!
This project is licensed under the MIT License - see the LICENSE file for details.
This integration is not officially affiliated with Octopus Energy Germany. Use at your own risk.