Skip to content
Homebridge TestFlight
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

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 HomebridgeNo
Homebridge versions^1.9.0 || ^2.0.0 || ^2.0.0-beta.23 || ^2.0.0-alpha.37
Homebridge 2.0Yes
Node.js^20 || ^22 || ^24
Settings in Homebridge UIYes
MatterNo
Platform nameSwitchBot
LicenseISC

Community signals

Downloads a week182
Downloads a month335
GitHub stars0
Open issues0
Closed issues0
Last code push2026-05-10
Latest version4.3.14 (2026-05-10)
First published2024-08-16
Releases9

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