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.