A Matterbridge plugin that connects SwitchBot Cloud and BLE devices to the Matter smart home ecosystem using the node-switchbot module.
- SwitchBot Cloud integration via the SwitchBot OpenAPI (token + secret required).
- SwitchBot BLE integration for local Bluetooth Low Energy device discovery.
- Supports a wide range of SwitchBot device types mapped to Matter device types:
| SwitchBot Device | Matter Device Type |
|---|---|
| Bot | On/Off Switch |
| Plug / Plug Mini | On/Off Outlet |
| Color Bulb / Strip Light | Extended Color Light |
| Ceiling Light / Ceiling Light Pro | On/Off Light |
| Meter / Meter Plus / Hub 2 | Temperature + Humidity Sensor |
| Curtain / Curtain3 / Blind Tilt | Window Covering (Cover) |
| Contact Sensor | Contact Sensor |
| Motion Sensor / Presence Sensor | Occupancy Sensor |
| Lock / Smart Lock Pro / Smart Lock Ultra | Door Lock |
| Robot Vacuum Cleaner S1 / S1 Plus / S10 / K10+ / K10+ Pro / WoSweeper | Robotic Vacuum Cleaner |
npm install -g matterbridge-switchbot
matterbridge -add matterbridge-switchbotEdit the plugin configuration in the Matterbridge frontend or directly in matterbridge-switchbot.config.json:
{
"name": "matterbridge-switchbot",
"type": "DynamicPlatform",
"token": "YOUR_SWITCHBOT_API_TOKEN",
"secret": "YOUR_SWITCHBOT_API_SECRET",
"enableBLE": false,
"whiteList": [],
"blackList": [],
"debug": false,
"unregisterOnShutdown": false
}- Open the SwitchBot app on your phone.
- Go to Profile → Preferences.
- Tap the app version number 10 times to reveal the developer options.
- Copy your Token and Client Secret.
Set enableBLE: true to enable Bluetooth Low Energy discovery. This requires:
- Bluetooth hardware available on the host system.
- Appropriate Bluetooth permissions (may require running as root or adding capabilities on Linux).
- Clone the repository.
- Install dependencies:
npm install - Link Matterbridge:
npm run dev:link - Build:
npm run build - Add to Matterbridge:
npm run matterbridge:add
- Matterbridge >= 3.4.0
- Node.js >= 20.19.0
Apache-2.0