SwitchBot Bluetooth
switchbot
SwitchBot Matter devices are certified for use via one of their Matter hubs: either the SwitchBot Hub 2 or the Hub 3. Some are also certified via Matter over Wi-Fi as standalone devices.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
cover | Garage door, blind | |
climate | Thermostat | |
fan | Fan | |
humidifier | Humidifier or dehumidifier | |
lock | Lock | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (contact, leak, motion, occupancy) | |
sensor | Sensor (CO₂, PM2.5, humidity, light level, temperature) | |
vacuum | Vacuum (as a switch) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Many SwitchBot BLE devices work locally via Bluetooth, but newest hardware and firmware (Lock Pro 0x2409, Meter fw 0.9, Keypad Vision) is often not detected until a library update.
- Works16
- Partly works3
- Not working2
- Requested2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| SwitchBot Air Purifier US model | Works Local | PM2.5 sensor addedSaved copyProposed change - Add pm25 sesnor ## Type of change - [ ] Dependency upgrade - [ ] Bugfix (non-breaking change which fixes an issue) - [ ] New integrat Excerpt saved from GitHub on 2026-10-23. | PR #167175 · 2026-04 | |
| SwitchBot BLE temperature and humidity sensors | Works Local | Usable outdoors; original batteries last over a yearSaved copyI use switchbot BLE temp and humidity sensors. They can be used outdoor. So far I have had them more than a year and haven't changed the original batteries. I have them in almost every room and outside. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-09 | |
| SwitchBot Bluetooth temperature sensor | Works Local | Works in the freezer over BluetoothSaved copyJust got an outdoor sensor, it should work. My Bluetooth SwitchBot sensors work in the freezer. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2023-11 | |
| SwitchBot Candle Warmer Lamp | Works Local | Brightness-only encrypted light addedSaved copyProposed change This PR adds support for the SwitchBot Candle Warmer Lamp (`SwitchbotModel.CANDLE_WARMER_LAMP`) to the SwitchBot integration. The Candle Warmer Lamp is a brightness-only encrypted light. It is wired up like the other SwitchBot lights via the generic `SwitchbotLightEntity`, exposing a single `ColorMode.BRIGHTNESS` light entity: - `const.py`: register the model in `SupportedModels`, `CONNECTABLE_SUPPORTED_MODEL_TYPES`, `ENCRYPTED_MODELS` and `ENCRYPTED_SWITCHBOT_MODEL_TO_CLASS` (mapped to `switchbot.SwitchbotCandleWarmerLamp`). - `init.py`: register `[Platform.LIGHT, … Excerpt saved from GitHub on 2026-10-23. | PR #173585 · 2026-06 | |
| SwitchBot curtain and blind tilt | Works | Work great but audible; hub distance mattersSaved copySwitchbot. I use the curtain pullers and the blind tilts and they work great. They're not overly quiet, but not obnoxiously loud either. You will hear them. I believe they have a quiet mode where they slow the motor down but I've never been bothered enough to try it. They are battery powered, batteries last a really long time and are all rechargeable, you can also get solar panels to keep them topped up. These are included with the blind tilts and work great in my experience. Note the blind tilts won't raise or lower the blind, only tilt the slats, and you'll need to get two curtain puller … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-01 | |
| SwitchBot curtains | Works | Curtains close automatically when Apple TV starts streamingSaved copyOne of my favourites combines our Apple TV and the SwitchBot curtains we own. When we start watching something from one of the streaming services, it automatically closes the curtains and dims the lights. But not if we just chuck something up on YouTube. Wife approval is super high, and when we have people over to watch something, they always comment. Now if only I could get it to work when we watch a DVD on the PS5... Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-04 | |
| SwitchBot Indoor/Outdoor Thermo-Hygrometer | Works Local | BLE broadcast sensor, works well and cheap for outdoor useSaved copyI use SwitchBot Indoor/Outdoor Thermo-Hygrometer which are BLE, work well, and are pretty cheap. I hsve a few other thermometers too, Hue outdoor motion sensors work well (but are pricey). YoLink work well, the update less often but have very good range and really long battery life. Ecowitt ones work nicely (I use one of their gateways). La Crosse View ones work OK most of the time, the Home Assistant integration is cloud-only (though you can use rtl433 to receive them if you want). Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-12 | |
| Switchbot IP65 outdoor hygrometer | Works Local | Bluetooth direct to HA via BT proxy, outdoor-ratedSaved copyI'm using Switchbot IP65 Indoor/Outdoor Hygrometer/Thermometer sensors and they work well. They are bluetooth direct to the Switchbot integration in HA. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-11 | |
| SwitchBot Lock | Works Local | Bluetooth, fits over existing lock; Lock Pro lacks HA integration yetSaved copySwitchbot. Got a really good discount as a kickstarter add on. Runs on Bluetooth and fits over the existing locks so I didn't need to change anything on the door itself. I have just upgraded one of them to the Lock Pro, but that one doesn't have HA integration yet :( Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-05 | |
| SwitchBot Lock Pro | Works Local | Support added in 2024 (older versions)Saved copyProposed change Add support to Switchbot Lock Pro, based on Danielhiversen/pySwitchbot#241. ## Type of change - [ ] Dependency upgrade - [ ] Bugfix (non-breaking change which fixes an issue) - [ ] New integration (thank you!) - [x] New feature (which adds function Excerpt saved from GitHub on 2026-10-23. | PR #119326 · 2024-06 | |
| SwitchBot Lock Ultra (via Matter hub) | Works Local | Listed as Matter device in docsSaved copySupported devices: SwitchBot Lock Ultra (via a Matter hub); SwitchBot Motion Sensor (via a Matter hub); SwitchBot Multitasking Robot K11+ (Matter over Wi-Fi). Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| SwitchBot Motion Sensor (via Matter hub) | Works Local | Listed as Matter device in docsSaved copySupported devices: SwitchBot Lock Ultra (via a Matter hub); SwitchBot Motion Sensor (via a Matter hub); SwitchBot Multitasking Robot K11+ (Matter over Wi-Fi). Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| SwitchBot Multitasking Robot K11+ | Works Local | Matter over Wi-Fi listed in docsSaved copySupported devices: SwitchBot Lock Ultra (via a Matter hub); SwitchBot Motion Sensor (via a Matter hub); SwitchBot Multitasking Robot K11+ (Matter over Wi-Fi). Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| SwitchBot Presence sensor | Works Local | Pairs directly to HA over Bluetooth without hub; gives occupancy and light levelSaved copyFYI, you absolutely can pair the Switchbot presence sensor directly to HA via Bluetooth (which gives you occupancy and light level) without using the Hub. You just need to set up the presence sensor settings in the Switchbot app first… Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2026-01 | |
| SwitchBot Presence Sensor | Works Local | Support added and tested on hardwareSaved copy… implementation (~93 lines, mostly tests) following recent merged PRs (#155124, #155309). Happy to receive feedback and make adjustments! ## Proposed change Add SwitchBot Presence Sensor support to the switchbot Bluetooth integration. The device combines mmWave radar, PIR sensor, and light detection. Already supported by PySwitchbot 0.73.0 (PR #410) and the `switchbot_cloud` integration (#155309), but missing from the Blu Excerpt saved from GitHub on 2026-10-23. | PR #156314 · 2025-11 | |
| SwitchBot S20 | Works Local | Support addedSaved copyProposed change - Add S20 ## Type of change - [ ] Dependency upgrade - [ ] Bugfix (non-breaking change which fixes an issue) - [ ] New integration (than Excerpt saved from GitHub on 2026-10-23. | PR #156368 · 2025-11 | |
| SwitchBot Bluetooth blinds tilt and LED | Partly works Local | Slow with USB adapter; ESP32 Bluetooth proxy made them responsiveSaved copyESP32 proxy changed all by switchbot devices further away from my server into hyper responsive tools. Bloody amazing Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-07 | |
| SwitchBot Indoor/Outdoor Thermometer fw 0.9 | Partly works Local | Not found after update to 0.9; hard restart by removing battery fixed itSaved copyThe problem I added succesfully 4x indoor/outdoor thermometer firmware V0.4 to HA. Once they were added, I was able to update them to firmware V0.9 and they keep working with the integration. However I upgraded two other new devices from V0.4 to V0.9 before adding them in HA, those ones are not found by the switchbot integration. The 2 new devices were part of the same 4 devices box, I bought 4x indoor/outdoor meter pack & only 2 of them with firmware V0.4 were detected/added by the integration, I think this is because the were detected while running with oldest stock firmware. As it's a gold … Excerpt saved from GitHub on 2026-10-23. | Issue #156126 · 2025-11 | |
| SwitchBot Remote | Partly works Local | Only battery level monitoring supportedSaved copyProposed change Add support for the Switchbot Remote to the _Switchbot Bluetooth_ integration. Currently just to monitor the battery level of the remote. The dependency upgrade PR has already been merged: https://github.com/hom Excerpt saved from GitHub on 2026-10-23. | PR #137443 · 2025-02 | |
| SwitchBot Lock Pro | Not working | Unusable in USA; proper components not sold for US locksSaved copyLooking for the same. Stay away from switchbot lock pro if you are in the USA. I have one sitting on a shelf unusable since they don’t sell or carry the proper components for USA locks. I have a Ubiquiti PoE door bell with fingerprint reader and some people have coupled that with a smart lock and use it to unlock their door. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-05 | |
| SwitchBot Lock Pro (new Wi-Fi version, fw 1.8) | Not working Local | Not detected over Bluetooth proxy with new manufacturer data 0x2409Saved copyThe problem I have a SwitchBot Lock Pro (firmware v1.8) that works correctly over BLE with an ESPHome Bluetooth Proxy (ESP32). However, the device is not recognized by Home Assistant when adding the "SwitchBot Bluetooth" integration, it simply does not appear in the list of detected devices. The ESPHome logs clearly show the device being detected, but Home Assistant never identifies it as a supported SwitchBot Lock Pro. ### What version of Home Assistant Core has the issue? core-2025.8.3 ### What was the last working version of Home Assistant Core? core-2025.8.3 ### What type of installation … Excerpt saved from GitHub on 2026-10-23. | Issue #154441 · 2025-10 | |
| SwitchBot Keypad Touch | Requested Local | Initial support PR closed unmergedSaved copyProposed change Adds support for the switchbot keypad touch. This requires merging of this pull request in pySwitchbot. Currently supports battery level and a sensor which changes on successful attempts. ## Type of change <!-- What type of change does your PR introduce to Home Assistant? NOTE: Please, check only 1! box! If your PR requires multiple boxes to be Excerpt saved from GitHub on 2026-10-23. | PR #128399 · 2024-10 | |
| SwitchBot Keypad Vision | Requested Local | Not recognised yet; doorbell press event unreliable over BLESaved copyThe problem I have a Switchbot lock ultra + keypad vision. The lock ultra is integrated into HA via Switchbot-BLE (working like a charme). 2026.02 added the keypad vision to the Switchbot integration, but it is not recognized when trying to add via Switchbot integration. The keypad vision shows the proper data (Service Data + the byte string to recognize and distinguish the keypad vision among Switchbot devices -> b'\x00\x11\x03x' as in the adv_parser.py of pyswitchbot library), see log entry and BLE advertisement data within HA. Active BLE Proxy is used (and working with the lock ultra). … Excerpt saved from GitHub on 2026-10-23. | Issue #162509 · 2026-02 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bluetooth
Details
| Installs (analytics) | 24,536 (3.46%) |
|---|---|
| Quality scale | Gold |
| Added in | Home Assistant 2025.6 |
| Set up in the UI | Yes |
| Maintainers | @danielhiversen, @RenierM26, @murtas, @Eloston |
Devices listed in its documentation
- SwitchBot Lock Ultra (via a Matter hub)
- SwitchBot Motion Sensor (via a Matter hub)
- SwitchBot Multitasking Robot K11+ (Matter over Wi-Fi)
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
