About
Home Assistant integration for Marstek energy storage devices (local UDP Open API)
Description from MarstekEnergy/ha_marstek
Shows in Vulpo
Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.Supports
- Works locallyTalks to your devices on your own network. No vendor cloud in between.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Add Marstek device
- HostThe IP address of your Marstek device on your local network.
- Device UDP portThe UDP port the device listens on. Default 30000; use 49152-65535 if you configured a custom port.
Marstek Energy Storage
- Select DeviceThe Marstek device discovered on your local network.
Also asked when at the marstek energy storage step.
Texts from the code of MarstekEnergy/ha_marstek.
Entities
- Binary sensorsCharge permission, Connected, Discharge permission
- NumbersDischarge depth (DOD)
- SelectsOperating mode, Maximum Grid power
- SensorsCT Phase A power, CT Phase B power, Battery power, Battery rated capacity, Battery remaining capacity, SOC, Battery status, Battery temperature, Bluetooth state, CT Phase C power, Device mode, Off-grid power, and 10 more
- SwitchesBluetooth lock, Front-panel LED
Actions
- Set operating modeSwitch a Marstek device to a new operating mode.
- Set discharge depthSet the discharge depth (DOD), 30-88 %.
- Set power versionSet the charge and discharge power version, in watts.
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
A Home Assistant integration for Marstek Energy devices (Venus series), communicating locally over the Marstek Device Local API
- SOC, Battery power, Battery charge/discharge status and remaining/rated capacity, Battery temperature
- Operating mode (Auto/ AI / Manual / Passive / UPS)
- Grid power, off-grid power and CT phase powers (A/B/C)
- Charge and discharge permission flags; device connectivity status
- WiFi signal strength, SSID and IP address (diagnostic, disabled by default)
- Per-input PV power, voltage, current and state (Venus A/D)
- Lifetime energy counters (PV, grid charge/discharge, load)
Information
- Installs
- 215 sharing analytics
- GitHub stars
- 40
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.3.0,
- Category
- Energy, Solar and batteries
- Kind
- Marketplace integration
- Brand
- Marstek
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
marstek- Issues
- Report an issue















