--- title: "SwitchBot Bluetooth" description: "SwitchBot Bluetooth is a built-in integration for Home Assistant. It has 24.6k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/switchbot" url: "https://vulpo.app/integrations/core/switchbot.md" last-updated: "2026-10-22" version: "1.4" --- # SwitchBot Bluetooth > SwitchBot Bluetooth is a built-in integration for Home Assistant. It has 24.6k installs sharing analytics and works locally. SwitchBot Bluetooth is a built-in integration that controls SwitchBot devices locally over Bluetooth. It covers many device types, with platforms for covers, locks, climate, fans, humidifiers, lights, vacuums, switches and buttons, plus sensors and binary sensors. Sensors include air quality level, light level, water level, radar and PIR trigger readings, and Bluetooth and Wi-Fi signal. Other controls cover child lock, oscillation, wireless charging, time format and the night light. Options set the curtain movement speed, force the Nightlatch mode and choose how many times commands are retried. Devices are found automatically on the network, and setup is done in the UI, where some devices ask for a password or encryption key. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=switchbot) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Gold quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services. ### Sign in - **Password**: The password required for the Bot device access ### Cloud login - **Password**: The password of your SwitchBot account - **Username**: The username of your SwitchBot account Also asked when at the encrypted auth step. ### Encrypted key - **Encryption key**: The encryption key for the device - **Key ID**: The ID of the encryption key ### Choose a device - **MAC address**: The Bluetooth MAC address of your SwitchBot device ### After setup - **Curtain movement speed**: Speed for curtain open and close operations (1-255, where 1 is slowest and 255 is fastest) - **Force Nightlatch operation mode**: Force Nightlatch operation mode even if Nightlatch is not detected - **Retry count**: How many times to retry sending commands to your SwitchBot devices Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Calibration, Auto-lock paused, Timeout, Unclosed alarm, Unlocked alarm, Duress alarm, Half-lock calibration, Half locked, High temperature, Lockout alarm, Low temperature - **Buttons**: Half lock, Light sensor, Next image, Previous image, Sync date and time - **Lights**: Light - **Numbers**: Display time offset, Horizontal oscillation angle, Vertical oscillation angle - **Selects**: Night light, Time format - **Sensors**: Air quality level, Battery range, Bluetooth signal, Light level, PIR triggered level, Radar triggered distance, Radar triggered level, Water level, Wi-Fi signal - **Switches**: Child lock, Horizontal oscillation, Vertical oscillation, Wireless charging ## Actions - **Add password**: Add a password to your keypad vision device. Fields: Device ID, Password ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## At a glance - Kind: Built-in integration - Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Wireless protocols - Brand: [SwitchBot](https://vulpo.app/integrations/switchbot.md) - Number: 24.6k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Gold quality scale - Domain: `switchbot` - Source: In Vulpo: Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity (Pro), Vacuum Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for SwitchBot | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [SwitchBot Cloud](https://vulpo.app/integrations/core/switchbot-cloud.md) | Built-in integration | 11.7k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant | | [SwitchBot Remote IR](https://vulpo.app/integrations/marketplace/kirapc-ha-switchbot-remote.md) | Marketplace integration | 512 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [SwitchBot KVS Camera](https://vulpo.app/integrations/marketplace/hsakoh-ha-switchbot-kvs-camera.md) | Marketplace integration | 77 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Magic Switchbot](https://github.com/ec-blaster/magicswitchbot-homeassistant) | Marketplace integration | 11 installs sharing analytics | Connection not stated | No update in over 18 months | | [SwitchBot\_press](https://github.com/cagnulein/switchbot_press) | Marketplace integration | 6 installs sharing analytics | Connection not stated | No update in over 18 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/switchbot --- - HTML version of this page: https://vulpo.app/integrations/core/switchbot - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml