switchbot-mqtt
switchbot-mqtt copied to clipboard
SwitchBot MQTT Home Assistant add-on
SwitchBot MQTT Home Assistant add-on
This project is a Home Assistant add-on that allows you to control various SwitchBot products through the API.
The add-on can also receive Webhooks to obtain the device's status. Via an MQTT broker, it will be detected as an MQTT integration in Home Assistant.
You can perform manual scene executions that were configured in the SwitchBot app, as well as control virtual infrared remote devices.
Important: Please note that this add-on does not support operations on SwitchBot devices via Bluetooth.
Current Support Status
Physical Devices
We have implemented all devices according to the published API specifications, but testing has been conducted only on a subset.
Device | Status | Webhook | Command | Verification |
---|---|---|---|---|
Bot | ✅ | ✅ | ✅ | |
Curtain | ✅ | ✅ | ✅ | ✅ |
Curtain3 | ✅ | ✅ | ✅ | |
Hub | - | - | - | |
Hub Plus | - | - | - | |
Hub Mini | - | - | - | |
Hub 2 | ✅ | ✅ | - | ✅ |
Meter | ✅ | ✅ | - | |
MeterPlus | ✅ | ✅ | - | ✅ |
Outdoor Meter | ✅ | ✅ | - | |
Smart Lock | ✅ | ✅ | ✅ | ✅ |
Keypad | ✅ | ✅ | ✅ | |
Keypad Touch | ✅ | ✅ | ✅ | |
Remote | - | - | - | - |
Motion Sensor | ✅ | ✅ | - | ✅ |
Contact Sensor | ✅ | ✅ | - | |
Water Leak Detector | ✅ | ✅ | - | |
Ceiling Light | ✅ | ✅ | ✅ | |
Ceiling Light Pro | ✅ | ✅ | ✅ | |
Plug Mini (US) | ✅ | ✅ | ✅ | |
Plug Mini (JP) | ✅ | ✅ | ✅ | ✅ |
Plug | ✅ | - | ✅ | |
Strip Light | ✅ | ✅ | ✅ | |
Color Bulb | ✅ | ✅ | ✅ | ✅ |
Robot Vacuum Cleaner S1 | ✅ | ✅ | ✅ | |
Robot Vacuum Cleaner S1 Plus | ✅ | ✅ | ✅ | |
Floor Cleaning Robot S10 | ✅ | ✅ | ✅ | |
Humidifier | ✅ | - | ✅ | |
Indoor Cam | - | ✅ | - | |
Pan/Tilt Cam | - | ✅ | - | |
Blind Tilt | ✅ | - | ✅ | |
Battery Circulator Fan | ✅ | ✅ | ✅ |
Virtual Infrared Remote Devices
Device | Command |
---|---|
Air Conditioner | ✅ |
TV | ✅ |
IPTV | ✅ |
Set Top Box | ✅ |
DVD | ✅ |
Fan | ✅ |
Projector | ✅ |
Camera | ✅ |
Others | ✅ |
Air Purifier | ✅ |
Speaker | ✅ |
Water Heater | ✅ |
Vacuum Cleaner | ✅ |
Light | ✅ |
Installation Method
For installation instructions, please refer to here.