Itead Sonoff, Electrodragon, Tasmota

Tasmota MQTT Switch

homebridge-mqtt-switch-tasmota · v0.9.9

Local

Exposes Sonoff and Electrodragon relay boards running Tasmota as HomeKit switches or outlets over MQTT.

View on npm Source code

What it says it supports

Brands

Itead Sonoff
Electrodragon
Tasmota

Devices it names

Sonoff
Electrodragon WiFi IoT Relay Board

Shows up in Apple Home as from its README

What people report

Controls Tasmota-flashed Sonoff switches over MQTT; Basic, Dual and S20 reported working, dimmers supported.

Works4

Device	Status	What they said	Source
BN-SZ01 dimmer	Works	Dimmer brightness support tested on Tasmota 6.1.1c Saved copy I add code to support dimmer with tasmota firmware 6.1.1c. Have tested on BN-SZ01. Excerpt saved from GitHub on 2026-10-22.	PR #46 · 2018-08
Sonoff Basic	Works	Works in Eve and Home Saved copy I have 2 Sonoff Basic, 2 Sonoff Dual R2 working using homebridge-mqtt-switch-tasmota in EVE and HOME. The also defined S20 (working in FHEM via MQTT Mosquitto) are not working via homebridge. Here is the corresponding part off my homebridge config.json: . . { "accessory": "mqtt-switch-tasmota", "switchType": "outlet", "name": "SonoffS2001", "url": "mqtt://ip-adress", "username": "username", "password": "geheim", "topics": { "statusGet": "stat/Sonoff2001/POWER", "statusSet": "cmnd/Sonoff2001/POWER1", "stateGet": "tele/Sonoff2001/STATE" }, "onValue": "ON", "offValue": "OFF", "manufacturer": … Excerpt saved from GitHub on 2026-10-22.	Issue #33 · 2018-03
Sonoff Dual R2	Works	Works; POWER1/POWER2 handling fixed Saved copy I have 2 Sonoff Basic, 2 Sonoff Dual R2 working using homebridge-mqtt-switch-tasmota in EVE and HOME. The also defined S20 (working in FHEM via MQTT Mosquitto) are not working via homebridge. Here is the corresponding part off my homebridge config.json: . . { "accessory": "mqtt-switch-tasmota", "switchType": "outlet", "name": "SonoffS2001", "url": "mqtt://ip-adress", "username": "username", "password": "geheim", "topics": { "statusGet": "stat/Sonoff2001/POWER", "statusSet": "cmnd/Sonoff2001/POWER1", "stateGet": "tele/Sonoff2001/STATE" }, "onValue": "ON", "offValue": "OFF", "manufacturer": … Excerpt saved from GitHub on 2026-10-22.	Issue #33 · 2018-03
Sonoff S20	Works	Initial failure was a topic typo Saved copy I have 2 Sonoff Basic, 2 Sonoff Dual R2 working using homebridge-mqtt-switch-tasmota in EVE and HOME. The also defined S20 (working in FHEM via MQTT Mosquitto) are not working via homebridge. Here is the corresponding part off my homebridge config.json: . . { "accessory": "mqtt-switch-tasmota", "switchType": "outlet", "name": "SonoffS2001", "url": "mqtt://ip-adress", "username": "username", "password": "geheim", "topics": { "statusGet": "stat/Sonoff2001/POWER", "statusSet": "cmnd/Sonoff2001/POWER1", "stateGet": "tele/Sonoff2001/STATE" }, "onValue": "ON", "offValue": "OFF", "manufacturer": … Excerpt saved from GitHub on 2026-10-22.	Issue #33 · 2018-03

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

MQTT broker

You’ll need

MQTT broker
Tasmota firmware

Compatibility

Verified by Homebridge	No
Homebridge versions	>=0.2.0
Homebridge 2.0	No
Node.js	>4.0.0
Settings in Homebridge UI	No
Matter	No
License	MIT

Community signals

Downloads a week	25
Downloads a month	73
GitHub stars	58
Open issues	38
Closed issues	21
Last code push	2019-11-22
Latest version	0.9.9 (2019-04-13)
First published	2017-02-24
Releases	12

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

Outlet
Switch