Marstek BLE for Home Assistant (Marketplace integration)

Installs: 167 sharing analytics
GitHub stars: 1
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.0.2, August 30, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Brand: Marstek
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: marstek_ct
Source: github.com/Cappa83/marstek-ble-ha
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Marstek BLE reads the Marstek CT002 smart meter and Venus E V3 battery over local Bluetooth. It uses the Home Assistant Bluetooth stack, including Bluetooth proxies, so the devices need no Wi-Fi, IP address, UDP or cloud access for the provided readings. The meter supplies sensors for total power, power and voltage per phase, signal strength and device version. The Venus battery adds sensors such as state of charge, state of health, battery voltage, temperatures and cell voltages, all taken from one read-only battery query. The CT002 is optional, so the integration can run with the meter only, with Venus devices only, or with both. Setup runs in the UI with automatic device discovery, and a Bluetooth address can be entered by hand; polling intervals for each device type are adjustable.

Automatic summary of the README and code of Cappa83/marstek-ble-ha. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Marstek BLE

CT002 (optional)Optional. Detected CT002 units appear as MST-TPM_… with their Bluetooth MAC. The MAC can be entered manually if needed.
Venus devicesSelect one or more detected Venus devices. Each selected device can then be named individually.
CT002 polling intervalOnly used when a CT002 is configured. Default and recommended: 5 s. Allowed: 1 to 300 s.
Venus polling intervalDefault: 150 s. Each cycle reads all selected Venus devices sequentially.

Venus name

Name

After setup

CT002 (optional)Optional. Select, change, or remove it. Without a CT002 the integration runs with the configured Venus devices only.
CT002 polling intervalOnly used when a CT002 is configured. Default and recommended: 5 s. Allowed: 1 to 300 s.
Venus polling intervalDefault: 150 s. One poll reads all selected Venus devices sequentially.
Venus devicesSelect, add, or remove devices. Each selected device can then be named individually.
Name

Texts from the code of Cappa83/marstek-ble-ha.

Entities

SensorsTotal power, Phase A power, Phase B power, Phase C power, Phase A voltage, Phase B voltage, Phase C voltage, BLE signal strength, Device version, SOC, State of health (SOH), Battery voltage, and 9 more

From the README

Stabile, schnelle und vollständig lokale BLE-Integration für Marstek CT Smart Meter / CT002 und Marstek Venus E V3 in Home Assistant.
Marstek BLE liest die unterstützten Geräte direkt über den nativen Bluetooth-Stack von Home Assistant aus. Home-Assistant-Bluetooth-Proxys werden unterstützt. Für die bereitgestellten Messwerte sind weder WLAN noch IP-Adresse, DHCP, UDP, Hersteller-Web-API oder Cloud-Zugriff des Marstek-Geräts erforderlich.
vollständig lokale BLE-Kommunikation
automatische Geräteerkennung über den Home-Assistant Config Flow
Discovery über lokale Bluetooth-Adapter und Home-Assistant-Bluetooth-Proxys
CT002 optional: CT-only, Venus-only oder gemischter Betrieb
CT002 standardmäßig alle 5 Sekunden
persistente BLE-Verbindung zum CT002
sequenzielle, kurze Venus-Abfragen
eine einzige Venus-BMS-Abfrage aktualisiert alle unterstützten BMS-Sensoren
keine zusätzlichen BLE-Abfragen durch das Aktivieren weiterer Venus-Sensoren
read-only: keine Steuerbefehle an Speicher oder EMS

From the README of Cappa83/marstek-ble-ha, Apache License 2.0. Shortened.