SwitchBot
SwitchBot
@nzws/homebridge-switchbot · v4.3.14
Local + cloudHomebridge 2.0
Adds SwitchBot sensors, humidifiers, bots, curtains, locks and hub-controlled IR devices to HomeKit.
What it says it supports
Brands
- SwitchBot
Devices it names
- Humidifier
- Evaporative Humidifier
- Meter
- Meter Plus
- Indoor/Outdoor Thermo-Hygrometer
- Motion Sensor
- Contact Sensor
- Hub Mini
- Hub 2
- Hub 3
- IR TV
- IR air conditioner
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- Air Conditioners and Heaters
- Air Purifiers
- Fans
- Humidifiers
- Windows and Coverings
- Locks
- Sensors
- Speakers
- TVs
- Robot Vacuum Cleaners
Sensor readings in its code
How it connects
Local + cloud
SwitchBot OpenAPI cloud or Bluetooth LE
You’ll need
- SwitchBot Hub for OpenAPI/IR devices
- SwitchBot API token
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.9.0 || ^2.0.0 || ^2.0.0-beta.23 || ^2.0.0-alpha.37 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | SwitchBot |
| License | ISC |
Community signals
| Downloads a week | 182 |
|---|---|
| Downloads a month | 335 |
| GitHub stars | 0 |
| Open issues | 0 |
| Closed issues | 0 |
| Last code push | 2026-05-10 |
| Latest version | 4.3.14 (2026-05-10) |
| First published | 2024-08-16 |
| Releases | 9 |
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.
Caveats from the README
- Customized fork of homebridge-switchbot
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
- ContactSensor
- Door
- Fanv2
- Faucet
- GarageDoorOpener
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- MotionSensor
- OccupancySensor
- Outlet
- StatefulProgrammableSwitch
- Switch
- Television
- TelevisionSpeaker
- TemperatureSensor
- Valve
- Window
- WindowCovering





