Skip to content
Homebridge TestFlight
Tasmota, ESPurna

MQTT Thing

homebridge-mqttthing · v1.1.50

Local

Adds many HomeKit accessory types controlled over MQTT topics.

What people report

Generic MQTT bridge, so devices work when topics are mapped; wiki holds user-tested configs for Tasmota and zigbee2mqtt devices.

  • Works24
  • Partly works6
  • Not working1
  • Requested2

The plugin’s own supported-device list

DeviceStatusWhat they saidSource
DHT11/DHT22 sensor on ESP8266 (Tasmota)WorksTemperature via MQTT topic and apply JSON parse; HTTP sensor plugin alternative
Saved copy
`{` `"accessory": "mqttthing",` `"type": "temperatureSensor",` `"name": "Bedroom Temperature",` `"url": "http://192.168.1.x:1883",` `"username": "x",` `"password": "x",` `"topics": {` `"getCurrentTemperature": {` `"topic": "tele/tempstation1/SENSOR",` `"apply": "return JSON.parse(message).AM2301.Temperature;"` `}` `}` `},` `{` `"accessory": "mqttthing",` `"type": "humiditySensor",` `"name": "Kids Room Humidity",` `"url": "http://192.168.1.x:1883",` `"username": "x",` `"password": "x",` `"topics": {` `"getCurrentRelativeHumidity": {` `"topic": "tele/tempstation2/SENSOR",` `"apply": "return …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2020-04
DIGOO DG-HOSA leak sensorWorksTested config via Sonoff RF Bridge
Saved copy
… device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the bridge: SECURI D026, the smallest overall sensor I have found …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Globe 34207 800lm RGBCCT bulbWorksTested with Tasmota template
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
HC-SR501 motion sensor on ESP8266WorksWorking for months with mqttthing; Tasmota setup was problematic
Saved copy
I used this one. Also with a SR501, and added a D11 for humidity and temp monitoring. It's been working well for months.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2020-12
IKEA TRADFRI LED bulbWorksTested E12/E14/E17 400lm and E27 1000lm via zigbee2mqtt
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
IKEA TRADFRI LED bulb white spectrum E27 806lmWorksTested config with colour temperature
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
IKEA Vindriktning (Tasmota)WorksTasmotized sensor works as airQualitySensor after fixing PM2.5 JSON key
Saved copy
You’re right that the problem is the dot in PM2.5. Right now you’re attempting to extract the value with this: JSON.parse(message).VINDRIKTNING.PM2.5; which is interpreted as: message object→`VINDRIKTNING`→`PM2`→`5` and `5` is not a valid property name in JavaScript so the runtime can’t interpret that line (can’t start with a number, hence the error saying “unexpected number at…”). Now, `JSON.parse()` is smart enough not to create invalid properties, so it correctly creates a property called “PM2.5”. You can’t use dot notation to access properties with dots in their name, since Js doesn’t …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-10
MagicHome RGBW LED stripWorksTasmota; parse RESULT topic for color
Saved copy
… (ZigBee) with Sonoff ZigBee Bridge Tasmota (ZigBee2Tasmota) [code] 0xAB2F is ZigBee device id taken from your ZigBee Bridge Thanks to bartoszwas IKEA TRADFRI LED Bulb Dimmable Configuration for IKEA TRADFRI LED bulbs, tested with: IKEA TRADFRI LED bulb E12/E14/E17 400 lumen, dimmable warm white, chandelier opal IKEA TRADFRI LED bulb E27 1000 lumen, dimmable, opal white The bulbs were connected to an USB Zigbee sniffer (CC2531) and communicate with the mqtt server via zigbee2mqtt. [code] Thanks to dylexrocks IKEA TRADFI LED Bulb Dimmable with Colour Temperature Adjustment …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Mirabella Genio LED bulbWorksTested with Tasmota template
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Mirabella Genio WiFi LED stripWorksTested with Tasmota template
Saved copy
… (ZigBee) with Sonoff ZigBee Bridge Tasmota (ZigBee2Tasmota) [code] 0xAB2F is ZigBee device id taken from your ZigBee Bridge Thanks to bartoszwas IKEA TRADFRI LED Bulb Dimmable Configuration for IKEA TRADFRI LED bulbs, tested with: IKEA TRADFRI LED bulb E12/E14/E17 400 lumen, dimmable warm white, chandelier opal IKEA TRADFRI LED bulb E27 1000 lumen, dimmable, opal white The bulbs were connected to an USB Zigbee sniffer (CC2531) and communicate with the mqtt server via zigbee2mqtt. [code] Thanks to dylexrocks IKEA TRADFI LED Bulb Dimmable with Colour Temperature Adjustment …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Mitsubishi AC with ESP8266 IR blasterWorksHeater-cooler device controlled reliably via MQTT; cannot read native HomeKit sensor temperature
Saved copy
… to get existing HomeKit devices to send their status to an MQTT broker? The use case I'm trying to solve for is the following: I've built a number of ESP8266-based IR blasters to control my Mitsubishi AC units. The software running on the ESP8266 uses MQTT to send and receive the commands, and I'm able to control them reliably via MQTT Thing plugin. I would like to use the temperature data from the sensors I already have around my house to feed into the "heater cooler" devices I've created via MQTT Thing, but I can't seem to find a way to output temperature data FROM HomeKit to MQTT.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit thread · 2022-06
MOES Carbon Monoxide AlarmWorksExplicit CO sensor support added via merged PR
Saved copy
Adding explicit support for Carbon Monoxide Sensor(s) such as the MOES Carbon Monoxide Alarm ZSS-HM-CO CC: [https://github.com/Koenkk/zigbee2mqtt/issues/19011]

Excerpt saved from GitHub on 2026-10-22.

PR #646 · 2023-10
OSRAM LIGHTIFY LED Classic B40 Tunable WhiteWorksTested via zigbee2mqtt
Saved copy
… (ZigBee) with Sonoff ZigBee Bridge Tasmota (ZigBee2Tasmota) [code] 0xAB2F is ZigBee device id taken from your ZigBee Bridge Thanks to bartoszwas IKEA TRADFRI LED Bulb Dimmable Configuration for IKEA TRADFRI LED bulbs, tested with: IKEA TRADFRI LED bulb E12/E14/E17 400 lumen, dimmable warm white, chandelier opal IKEA TRADFRI LED bulb E27 1000 lumen, dimmable, opal white The bulbs were connected to an USB Zigbee sniffer (CC2531) and communicate with the mqtt server via zigbee2mqtt. [code] Thanks to dylexrocks IKEA TRADFI LED Bulb Dimmable with Colour Temperature Adjustment …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Philips Hue Filament bulbWorksBrightness-only config via zigbee2mqtt
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Philips Hue GO bulbWorksTested via zigbee2mqtt with HSV conversion
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
ratgdo garage door controllerWorksWorks via MQTT config; obstruction needs apply() boolean conversion; Node-RED also works
Saved copy
… it and made one tweak. Mqtthing expects a boolean for getObstructionDetected, so I used an apply() to convert it: "getObstructionDetected": { "topic": "ratgdo-45307/status/obstruction", "apply": "return (message == 'obstructed');" },

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2023-11
Shelly AMAX (security system codec)WorksExample codec ShellyAMAX.js supplied with AltSensorState
Saved copy
In order to helps discovering currentState on systems with three sensors, this will add a getAltSensorState topic. an example of use is available in the codec directory: ShellyAMAX.js I hope it could help

Excerpt saved from GitHub on 2026-10-22.

PR #503 · 2021-11
Sonoff Basic ZBR3 (Zigbee2Tasmota)WorksTested config via Sonoff ZigBee Bridge
Saved copy
… Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the bridge: SECURI D026, the smallest overall sensor I have found …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Sonoff RF Bridge 433 (Tasmota)WorksTested config with SECURI D026 door sensor and Sonoff motion sensor
Saved copy
Please click one of the following links to quickly jump to the top of any device category. Bridges Bulbs and Lights Dimmers and Switches Garage Door Openers Heaters and Coolers Lock Mechanism Outlets and Plugs Security System Sensors: Air Quality and Carbon Dioxide Sensors: Contact and Motion Sensors: Humidity and Temperature Sensors: Leak Sensors: Smoke Switches Thermostats Window Coverings BRIDGES Sonoff RF Bridge 433 Configuration for Sonoff RF Bridge 433 with Tasmota firmware https://www.itead.cc/wiki/Sonoff_RF_Bridge_433 and more specifically for very chip accessors cooperating with the …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Sonoff RF Bridge with TasmotaWorks433MHz button exposed as motion sensor for doorbell; works perfectly
Saved copy
I just use an 433mhz RF button with a flashed Sonoff bridge using tasmota. Homebridge plugin is the mqtt things and set the button up as a motion sensor to get alerts. Works perfect. Even gets exposed to Alexa through the homebridge Alexa plugin so when someone presses the button Alexa plays the doorbell sound if you don’t want notifications that are just on your watch and phone.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-07
Tuya dimmers and devices flashed with TasmotaWorksReflashed with Tasmota via tuya-convert; works after homebridge-tuya-lan repo disappeared
Saved copy
With my Tuya devices I reflashed them with Tasmota, and now use homebridge-mqtt-thing. No more Tuya access to my devices. For flashing instructions, take a look at this. https://github.com/ct-Open-Source/tuya-convert

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2019-04
Z-Wave devices via Zwave2MQTTWorksRuns reliably with Zwave2MQTT and Mosquitto
Saved copy
I’ve got my parents house running on Zwave2MQTT, talking to Homebridge via the MQTTThing plug-in. All three things, Zwave2MQTT, Mosquitto, and Homebridge, are spun up with Docker running on an old laptop that I installed Alpine Linux on. There’s basically no moving parts once I got it all set up, my dad can tinker with automations in HomeKit to his heart’s content without breaking anything on the “technical” side. If that machine ever dies I can just clone the GitHub repo down on a new machine and off it goes (I tested this). I also left them an unattended Linux install stick, so I could …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2020-12
Z-Wave lock via Zooz S2 stickWorksLock and unlock from HomeKit; set codes in Z-Wave panel
Saved copy
I’m in the process of moving off of SmartThings, and I am looking for a way to bring my Z-wave lock into HomeKit. Is there a chain of software with a Z-wave stick that will let me do this in a reasonable way that won’t break all the time?? Edit, for people from the future: this post got me 80% of the way there https://reddit.com/r/homebridge/comments/gvtauo/zwave_to_homekit_how_i_did_it/ Mosquitto + Zwave2mqtt + homebridge-mqttthing, and a Zooz S2 zwave USB stick. I can lock and unlock from HomeKit and set codes from the zwave control panel.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit thread · 2020-10
Z-Wave sensors via zwave2mqttWorkszwave2mqtt with mqttthing works really well
Saved copy
Yep, I use one with zwave2mqtt and the mqttthing plugin for Homebridge. Works really well for me.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2020-10
BME680 sensorPartly worksNeeds apply function to map values to air quality; no gas driver
Saved copy
Yes this is the problem...to calculate the corresponding ppm value we need to include the BME680 driver by Bosch else we have a resistor value I've already implemented something like what you said but obviously without the driver included into homebridge-mqttthing will not work properly.. "topics": { "getAirQuality": { "topic": "tele/GAS/SENSOR", "apply": "gas = JSON.parse(message).BME680.Gas; return (gas > 2000 ? 'POOR' : gas > 1600 ? 'INFERIOR' : gas > 1100 ? 'FAIR' : gas > 700 ? 'GOOD' : gas <= 700 ? 'EXCELLENT' : 'UNKNOWN');" }, "getAirQualityPPM": { "topic": "tele/GAS/SENSOR", "apply": …

Excerpt saved from GitHub on 2026-10-22.

Issue #276 · 2020-05
Deta Grid Connect Smart 10W LED downlightPartly worksTasmota; warm and cool white reversed in Home app
Saved copy
… (ZigBee) with Sonoff ZigBee Bridge Tasmota (ZigBee2Tasmota) [code] 0xAB2F is ZigBee device id taken from your ZigBee Bridge Thanks to bartoszwas IKEA TRADFRI LED Bulb Dimmable Configuration for IKEA TRADFRI LED bulbs, tested with: IKEA TRADFRI LED bulb E12/E14/E17 400 lumen, dimmable warm white, chandelier opal IKEA TRADFRI LED bulb E27 1000 lumen, dimmable, opal white The bulbs were connected to an USB Zigbee sniffer (CC2531) and communicate with the mqtt server via zigbee2mqtt. [code] Thanks to dylexrocks IKEA TRADFI LED Bulb Dimmable with Colour Temperature Adjustment …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Tested Configurations
Hisense AC (ConnectLife)Partly worksVia MQTT integration; user found it not great and removed it
Saved copy
It wasn’t too great. I ended up removing it and just going through the connect life app.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2024-02
MQTT accessoriesPartly worksNot actively developed; homebridge-easy-mqtt suggested as replacement
Saved copy
Excuse the shameless plug, but I created homebridge-easy-mqtt as a modern replacement for MQTTThing since that plugin doesn't appear to be actively developed anymore. Easy MQTT is not a drag-and-drop migration, I'm afraid, so it does require a bit of configuration. But I'm actively maintaining and improving it and am very open to feedback.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2026-05
Wyze Sense sensorsPartly worksWorks via gosenseapp and MQTT; bug in motion sensor events
Saved copy
I have the wyze sensor working in homebridge. First use gosenseapp on the pi add the sensors and publish events to mqtt. Then I use the homebridge mqttthing plugin to integrate into homebridge. It's been working great for me. There is a bug in the motion sensor events, but I kinda worked around it with a config change. I use homebridge, gosenseapp and Mosquitto all on a single pi. https://github.com/dariopb/ha-gosenseapp https://github.com/arachnetech/homebridge-mqttthing#readme

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2020-02
Xiaomi LYWSD02 BLE sensor (Tasmota)Partly worksWorks after config tweaks but logs warnings and exceptions
Saved copy
… LYWSD03MMC with modified firmware via https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html , Advertising type set yo PVVX, i have a ESP32 running Tasmota 32 Bluetooth, this detects the sensors then sends to mqtt i have set MI32Option6 1 so the each sensor gets a unique tele topic. i set this up as a rule so starts up on boot rule1 on system#boot do backlog MI32Option6 1; MI32Period 60 endon rule1 1 { "accessory": "mqttthing", "type": "weatherStation", "name": "XXXXXXXXX", "url": "mqtt://XXXXXXXX", "username": "XXXXXXX", "password": "XXXXXXX", "caption": "XXXXXXX", "mqttOptions": { …

Excerpt saved from GitHub on 2026-10-22.

Issue #546 · 2022-03
Show 3 more
DeviceStatusWhat they saidSource
Aqara round temperature sensorNot workingTested config for round Xiaomi sensor did not work
Saved copy
I have installs on a Raspberry Pi 4 HOOBS 3, zigbee2mqtt and mosquitto broker. I can view the Aqara temperature and humidity sensor via MQTT Explorer, but I don't know which parameters must be entered in the homebridge-mqttthing plugin to configure it on homebridge / HOOBS. Someone who has already had the opportunity to configure it or who knows what parameters to insert? Thanks.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit thread · 2020-01
Aqara Cube T1 ProRequestedUser asks for support; open
Saved copy
I'm trying to use the Aqara Cube (official model name T1 Pro) though I have the zigbee Xiaomi MFKZQ01LM

Excerpt saved from GitHub on 2026-10-22.

Issue #643 · 2023-09
ratgdo garage door controllerRequestedTwo dedicated plugins in development; MQTTThing planned as interim via ratgdo MQTT
Saved copy
There are two plugins in process. https://github.com/ratgdo/homekit-ratgdo https://github.com/hjdhjd/homebridge-ratgdo

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2023-10

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

Compatibility

Verified by HomebridgeNo
Homebridge versions>=1.11.0 <3.0.0-0
Homebridge 2.0No
Node.js^18.12.0 || ^20.10.0 || ^22.11.0 || ^24.12.0
Settings in Homebridge UIYes
MatterNo
Platform namemqttthing
LicenseApache-2.0

Community signals

Downloads a week207
Downloads a month1,807
GitHub stars495
Open issues220
Closed issues382
Discussions26
Last code push2026-10-01
Latest version1.1.50 (2026-10-01)
First published2017-07-02
Releases100

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.

  • AirPurifier
  • AirQualitySensor
  • Battery
  • CarbonDioxideSensor
  • CarbonMonoxideSensor
  • ContactSensor
  • Door
  • Doorbell
  • Fan
  • Fanv2
  • FilterMaintenance
  • GarageDoorOpener
  • HeaterCooler
  • HumidifierDehumidifier
  • HumiditySensor
  • InputSource
  • IrrigationSystem
  • LeakSensor
  • LightSensor
  • Lightbulb
  • LockMechanism
  • Microphone
  • MotionSensor
  • OccupancySensor
  • Outlet
  • SecuritySystem
  • ServiceLabel
  • SmokeSensor
  • Speaker
  • StatelessProgrammableSwitch
  • Switch
  • Television
  • TelevisionSpeaker
  • TemperatureSensor
  • Thermostat
  • Valve
  • Window
  • WindowCovering