Hi everyone,
I'd like to share a custom integration I've been working on for Octopus Energy Italy customers:
Octopus launched in Italy on its Kraken platform, but the well-known UK integration doesn't work with the Italian GraphQL APIs - so I built a dedicated one from scratch, based on the official Octopus Energy Italy developer APIs.
What it does:
- Full Italian market data – accounts, ledgers/balances, properties, POD (electricity) and PDR (gas) supply points, with multi-account support
- Detailed tariffs – active product with base/F2/F3 prices, standing charges, gas price in €/m³, contract start/end dates and a days-until-expiry sensor
- Smart meter readings – cumulative readings compatible with the HA Energy dashboard, plus daily consumption sensors
- Intelligent Octopus / SmartFlex – planned dispatch windows, a binary sensor that turns on during an active charging window, charge target (number), target time (select), smart-control and boost switches, and a
set_device_preferencesservice - Public tariffs monitoring – one sensor per tariff published on the Octopus IT website (including PLACET offers), handy to compare your contract against current offers
- Bilingual entities (Italian/English), DataUpdateCoordinator-based, with a pytest suite covering API client, sensors, switches and coordinator logic
Installation: via HACS (search "Octopus Energy Italy") or manual copy of custom_components/octopus_energy_it. Requires HA 2025.4.0+.
If you charge an EV with a V2C wallbox, it pairs nicely with my companion integration for direct V2C Cloud telemetry and control: GitHub - samuelebistoletti/HomeAssistant-V2C-Cloud: V2C Cloud Home Assistant Integration · GitHub
Feedback, issues and PRs are very welcome - especially from other Italian Octopus customers, since some tariff combinations are hard to test with a single account. 
Thanks!
Samuele
