Skip to content

Compared with other integrations ​

There are several ways to get a Marstek battery into Home Assistant. They differ mostly in how they talk to the battery, and that decides which batteries they support and what extra hardware you need. Words like UDP, Modbus, and MQTT are explained in the glossary. This page is written by the maintainers of one of them, so check the links and judge for yourself.

Last reviewed 2026-10-28

Release and activity facts come from each project's own GitHub page on that date. Projects change quickly. Every change to this page is in its Git history. Corrections are welcome as a pull request.

First, pick a connection type ​

ConnectionHow it worksExtra hardwareGood for
Local Open API (UDP)Home Assistant asks the battery over Wi-Fi or Ethernet, using the Open API you enable in the Marstek app.NoneVenus A, C, D, E 3.0, E mini, and Venus E 2.0 (experimental). No wiring.
Modbus TCPHome Assistant reads and writes the battery's settings over a wired connection.An RS485-to-Ethernet adapter on most models, which connects the battery's RS485 wiring port to your network. Some newer models offer Modbus over Ethernet directly.Venus E 2.0, and anyone who wants a wired connection that doesn't use the Open API.
MQTTThe battery's cloud connection is redirected to an MQTT broker (a small message server) on your own network.An MQTT broker and a bridge add-onB2500 and Jupiter, which have no Open API.
CloudHome Assistant logs in to Marstek's servers.NoneRead-only monitoring when nothing local works. Stops when the cloud is down.
BluetoothHome Assistant reads the battery over Bluetooth Low Energy.A Bluetooth adapter or proxy in rangeRead-only monitoring.

Open API (UDP) integrations ​

All three use the same local interface as this one, so they share its limits: Home Assistant has to poll for changes, and older firmware is fragile. This integration adds Venus E 2.0 with an experimental-support warning. The others do not.

FeatureThis integrationMarstek (vendor)Marstek Venus E (yuyuki)Marstek Local API (jaapp)
Repositorytaurgis/has-marstek-local-apimarstekEnergy/ha_marstekyuyuki/hacs_marstek_venus_ejaapp/ha-marstek-local-api
ModelsVenus A, C, D, E 3.0, E mini, E 2.0 (experimental)Venus E 3.0, A, DVenus EVenus C, D, E
Mode selectAuto, AI, and UPS where the firmware allows it. Manual and Passive are shown, but set through device actions and servicesAuto, AI, Manual, UPSAuto, AI, Manual, PassiveButtons for Auto, AI, Manual
Passive modeYesYes (service)YesYes
Manual schedulesYesExperimentalYesYes
Depth of discharge, LED, BluetoothYes, depending on firmwareYesNoNo
Several batteries as one deviceNo (comparison dashboard)NoNoYes
Battery health estimateYesNo¹No¹No¹
InstallHACS customHACS customHACS customHACS custom
Latest releasev1.11.0 (2026-10-28)v0.2.3 (2026-10-27)None published1.2.0.rc7 (2025-11-03)
Recent activityActive (Oct 2026)ActiveActive (Sept 2026)No commits since Nov 2025. An active fork exists (below)
LicenseMITMITMITNone (no license file)

What to know about each ​

Marstek (vendor). Published by Marstek's own GitHub organization. Marstek also has a pull request open to add a Marstek integration to Home Assistant itself. That pull request is still a draft and, in its current form, adds sensors only. Its HACS version does more, including a factory-reset button, which this integration leaves out on purpose. If it is merged, Marstek support will come with Home Assistant out of the box.

yuyuki. Focused on one model, Venus E, with mode, passive, and schedule control. A good fit if that's all you have and you want a smaller integration.

jaapp. Adds several batteries together into a "system" device. The original is still a release candidate and has had no commits since November 2025. Flodesirat's fork keeps the system device and is actively maintained (GPL-3.0).

¹ Marstek Capacity Monitor, in the HACS default store, measures capacity next to any of these integrations.

This integration. The broadest model support (the only one here that lists Venus E mini), firmware-aware controls, a battery health estimate, and tests that run Marstek's own firmware in an emulator. In exchange, it is one entry per battery with no combined system device. See Limitations.

Only one at a time

This integration, Marstek's vendor integration, and the proposed built-in one all install under the same name, marstek. Home Assistant can load only one. Remove one completely, restart, then install the other. A custom integration always wins over a built-in one with the same name, so if the built-in one ships, remove this one first to try it.

Modbus integrations ​

These need a wired connection, usually an RS485-to-Ethernet adapter, but they don't depend on the Open API at all. That makes them a good option for Venus E 2.0 when the shared meter channel makes Open API polling a poor fit.

Omnibattery ​

  • Repository: ffunes/Omnibattery
  • Models: Venus A, C (v2/v3), D, E (v2/v3), plus batteries from other brands.
  • What it does: a full energy manager with zero-export control, time slots, price-based charging, and up to 10 batteries.
  • Install: HACS custom repository. License: GPL-3.0. Latest release: 1.5.0 (2026-10-04).

Marstek Venus Modbus ​

  • Repository: ViperRNMC/marstek_venus_modbus
  • Models: Venus A, D, E v1, v2, and v3.
  • What it does: force charge and discharge, power and charge limits, and schedules.
  • Install: HACS custom repository. License: MIT. Latest release: 2026.10.1 (2026-10-26).

Marstek Modbus Suite ​

  • Repository: sphings79/marstek-modbus-suite
  • Models: Venus A, D, E v3. Its README marks E v1 and v2 as unverified.
  • What it does: control plus a dashboard panel.
  • Install: HACS default store. License: MIT. Latest release: 3.1.3 (2026-10-28).

Omnibattery replaces the earlier Marstek Venus Energy Manager by the same author.

MQTT, cloud, and Bluetooth ​

hm2mqtt (MQTT) ​

  • Repository: tomquist/hm2mqtt
  • Covers: B2500, Venus A, C, D, E, E mini (beta), Jupiter, and CT meters, with sensors and control.
  • Install: a Home Assistant add-on or Docker container, not HACS. Venus and Jupiter keep talking to Marstek's cloud. The companion hame-relay mirrors that data locally using your Marstek account, so this route still depends on the cloud. marsrelay is a newer offline option.

Marstek Cloud ​

  • Repository: DoctaShizzle/marstek_cloud
  • Covers: sensors only, read from Marstek's servers.
  • Install: manual copy. No commits since October 2025.

Marstek BLE (Bluetooth) ​

  • Repository: Cappa83/marstek-ble-ha
  • Covers: CT002 and Venus E 3.0, read-only.
  • Install: HACS custom repository. License: Apache-2.0.

AstraMeter ​

AstraMeter (formerly b2500-meter) is not an integration, but it is useful next to one: it pretends to be a Marstek CT meter, so a battery in Auto mode can follow a meter you already have in Home Assistant. This project uses it to test against real firmware.

Which one should I use? ​

  • Venus A, D, E 3.0, or E mini, and you want no extra hardware: an Open API integration. Pick this one for the widest model support, firmware-aware controls, and battery health. Pick the vendor one if you prefer Marstek's own code.
  • Venus E 2.0: this integration, with the experimental warning. It uses the same feature gates as Venus C. Depth of discharge, the panel LED, and Bluetooth start at firmware 158 (158.1 counts as 158). UPS is not offered: that firmware accepts the command and then reports Manual. The shared meter channel is still there (#82, #121). A Modbus integration, or hm2mqtt over MQTT, avoids that channel.
  • Venus C: an Open API integration works, but read the Venus C caveat first.
  • Venus E mini: this is the only Open API integration above that lists it. hm2mqtt has beta support over MQTT.
  • B2500 or Jupiter: hm2mqtt. There is no local Open API for those.
  • You want an automatic energy manager rather than building automations yourself: Omnibattery.
  • You want several batteries combined into one device: Flodesirat's maintained fork of jaapp's integration, or Omnibattery over Modbus.

Decided on this one? Check your battery, then follow Getting started. It takes about 20 minutes.