Plum ecoMAX for Home Assistant (Marketplace integration)

Installs: 68 sharing analytics
GitHub stars: 51
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v0.5.0, October 27, 2026
Category: Climate
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: plum_ecomax
Source: github.com/denpamusic/homeassistant-plum-ecomax
Issues: Report an issue

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

About

Plum ecoMAX is an integration for ecoMAX boiler controllers made by Plum, connected locally to Home Assistant. It reads the controller over RS-485, through a USB adapter or a network converter, using the PyPlumIO library. It adds binary sensors, sensors, numbers, selects, switches, a thermostat climate entity and a water heater entity for an indirect water heater. Mixers and circuits appear as sub-devices with their own temperatures, pump state and limits, and available entities depend on the controller model and connected modules. Actions can get or set device parameters and schedules, and calibrate or reset a meter. An alert event is fired when the controller reports an alert, and diagnostics and system health are included. Setup is done in the UI by choosing a serial or network connection.

Automatic summary of the README and code of denpamusic/homeassistant-plum-ecomax. 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

Climate
Water heaters
Switches
Sensors

Setting it up

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

Serial settings

Baudrate
Device

Network settings

Host
Port

After setup

Source device
Entity
Device class
Key
Mode
Name
State class
Unit of measurement
Update interval
Entity

Texts from the code of denpamusic/homeassistant-plum-ecomax.

Entities

Binary sensorsAlert, Circuit pump, Circulation pump, Connection status, Exhaust fan, Fan, Feeder, Fireplace pump, Heating pump, Lighter, Mixer pump, Solar pump, and 1 more
ClimateThermostat
NumbersDay target circuit temperature, Fuel calorific value, Fuzzy logic maximum power, Fuzzy logic minimum power, Grate mode temperature, Maximum circuit temperature, Maximum heating temperature, Maximum mixer temperature, Minimum circuit temperature, Minimum heating temperature, Minimum mixer temperature, Night target circuit temperature, and 3 more
SelectsWork mode, Summer mode
SensorsBoiler load, Boiler power, Circuit target temperature, Circuit temperature, Connected modules, State, Exhaust temperature, Fan power, Feeder temperature, Fireplace temperature, Flame intensity, Fuel consumption, and 17 more
SwitchesController switch, Disable pump on thermostat, Enable circuit, Enable in summer mode, Fuzzy logic switch, Heating schedule switch, Water heater disinfection switch, Water heater pump switch, Water heater schedule switch, Weather control switch
Water heatersIndirect water heater

Actions

Calibrate meterAllows to calibrate meter by pre-setting it's value.Fields: Value
Get parameterGets device parameter.Fields: Device, Name
Get scheduleGets device schedule.Fields: Device, Type, Weekdays
Reset meterResets meter value.
Set parameterSets device parameter.Fields: Device, Name, Value
Set scheduleSets device schedule.Fields: Device, End time, Preset, Start time, Type, Weekdays