MQTT
@uboness/homebridge-mqtt · v0.4.0
Maps MQTT topics to a wide range of HomeKit services.
What it says it supports
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- Buttons and Remotes
- Thermostats
- Air Conditioners and Heaters
- Fans
- Humidifiers
- Windows and Coverings
- Doors and Windows
- Locks
- Security Systems
- Doorbells
- Sensors
- Speakers
Sensor readings in its code
What people report
- Works1
- Partly works3
| Device | Status | What they said | Source |
|---|---|---|---|
| RF ceiling fan (RH787T remote) | Works | Recorded RF signals replayed via rpitx on Pi; homebridge MQTT controlSaved copyI have a dumb fan in my bedroom that uses an RH787T remote for basic RF control. I started by getting an RTL-SDR dongle, and using Cubic SDR on my Mac to look for the signal when I pressed the button. The signal shows up on 303.8 MHz when I press a button. I downloaded rpitx to my Raspberry Pi 3B+, plugged in the SDR dongle, and recorded each button press. Then I got a small jumper wire and attached it to GPIO pin 4, played back the signal from rpitx and... nothing. Try again, move the Pi into the same room, and the fan changes! So now I've got all of the signals recorded and I can play them … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2020-11 |
| Legrand Adorne WiFi dimmers LC7001 | Partly works | Used with WiZ lights via MQTT; one user has 100 WiZ lights on dimmers fineSaved copySo, I like the Wiz recessed lights and I love the Adorne Wifi switches. Now that the whole house is on both, my plan is to create MQTT events that dim the wiz brightness for lights in a room based on the dimmer setting of the adorne wifi dimmers. The dimmers do lower the amperage to the lights, but not enough to actually drop them from wifi. They require very little power to stay functioning properly. I'm just starting this journey, and have everything I think I should need installed now. Homebridge MQTT, homebridge automation for node-red, and node-red itself. Has anyone else done something … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2023-02 |
| Mitsubishi HVAC unit | Partly works | Poster building ESP8266 HeatPump firmware; HomeKit lacks dual swing modesSaved copyI’m making an ESP8266 firmware to publish an HVAC accessory to Homebridge, can someone show me screenshots of how an HVAC unit is represented in the Home app and how the functions work? I can control it how I want, but the HK services don’t mirror how the HVAC expects to work. For example, a fan can only have one swing mode, but this has both horizontal and vertical. For the curious or interested, I’m using HeatPump to control a Mitsubishi HVAC unit and publish it to HB using Homebridge-MQTT. Thanks in advance. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2020-09 |
| ratgdo (HomeKit and MQTT firmware) | Partly works | MQTT firmware needs a broker, hard in Homebridge; HomeKit firmware worked for one userSaved copyI used the HomeKit firmware. I did have to install it a second time due to connectivity issues. It may have been related to my WiFi network. It has been working fine now for several days…I installed it within the last week and loving it! Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2024-04 |
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 Homebridge | No |
|---|---|
| Homebridge versions | ^1.11.4 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^18.20.4 || ^20.15.1 || ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | Mqtt |
| License | Apache-2.0 |
Community signals
| Downloads a week | 35 |
|---|---|
| Downloads a month | 62 |
| Latest version | 0.4.0 (2026-05-01) |
| First published | 2025-01-25 |
| Releases | 26 |
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.
- Battery
- CarbonDioxideSensor
- CarbonMonoxideSensor
- ContactSensor
- Door
- Doorbell
- Fanv2
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- Microphone
- MotionSensor
- OccupancySensor
- Outlet
- SecuritySystem
- SmokeSensor
- Speaker
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor
- Thermostat
- Window
- WindowCovering