Back to the overview

SwitchBot Bluetooth in Home Assistant

switchbot part of Home Assistant since 0.78

Local, push Set up in the user interface Quality: Gold

SwitchBot Bluetooth is an official Home Assistant integration for Binary sensor, Button, Climate, Cover, Fan, Humidifier, Light, Lock, Select, Sensor, Switch and Vacuum. Talks to the device on your own network and is told about every change straight away.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Single device
Quality scale
Gold – Very good user experience: set up in the interface, discovered automatically, documented in detail.
Installations
23,639 (3.5 % of the installations that share statistics)
Categories
Binary sensor, Button, Climate, Cover, Fan, Humidifier, Light, Lock, Select, Sensor, Switch, Vacuum
Provides
Binary sensor, Button, Climate, Cover, Diagnostics, Event, Fan, Humidifier, Light, Lock, Number, Select, Sensor, Switch, Vacuum
Found automatically via
Bluetooth
Maintained by
@danielhiversen, @RenierM26, @murtas, @Eloston, @dsypniewski, @zerzhang
Python packages
PySwitchbot==2.7.0

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for SwitchBot Bluetooth.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Known issues and fixes

18 open issues and 12 bug fixes in the last twelve months are recorded for SwitchBot Bluetooth in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.0.

Open

  • open Reported problem #170232 since May 9, 2026 · 11 reactions · 34 comments · #170232
  • open Reported problem #154467 since October 14, 2025 · 11 reactions · 9 comments · #154467
  • open Reported problem #161969 since January 31, 2026 · 6 reactions · 16 comments · #161969
  • open Reported problem #145851 since May 29, 2025 · 4 reactions · 16 comments · #145851
  • open Reported problem #172800 since June 1, 2026 · 3 reactions · 8 comments · #172800
  • open Reported problem #167517 since April 6, 2026 · 3 reactions · 5 comments · #167517
  • open Reported problem #165119 since March 8, 2026 · 2 reactions · 12 comments · #165119
  • open Reported problem #162509 since February 7, 2026 · 2 reactions · 12 comments · #162509

Fixed

Source: the issue tracker of Home Assistant, as of September 14, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top