Back to the overview

SwitchBot Cloud in Home Assistant

switchbot_cloud part of Home Assistant since 2023.10

Cloud, polling Set up in the user interface

SwitchBot Cloud is an official Home Assistant integration for Binary sensor, Button, Cover, Fan, Hub, Humidifier, Light, Lock, Plug, Remote, Sensor, Switch and Vacuum. Works through the manufacturer’s cloud and asks for changes at regular intervals – it depends on the internet connection and the service.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Cloud, polling – Works through the manufacturer’s cloud and asks for changes at regular intervals – it depends on the internet connection and the service.
Setup
in the user interface
Kind
Hub – several devices through one gateway or account
Installations
11,074 (1.6 % of the installations that share statistics)
Categories
Binary sensor, Button, Cover, Fan, Hub, Humidifier, Light, Lock, Plug, Remote, Sensor, Switch, Vacuum
Provides
Binary sensor, Button, Climate, Cover, Fan, Humidifier, Image, Light, Lock, Select, Sensor, Switch, Vacuum
Maintained by
@SeraphicRav, @laurence-presland, @Gigatrappeur, @XiaoLing-git
Python packages
switchbot-api==2.13.0

Setup

  1. In Home Assistant open Settings → Devices & services.
  2. Click "Add integration" and search for SwitchBot Cloud.
  3. 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

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

Open

  • open Reported problem #175156 since June 30, 2026 · 4 reactions · 13 comments · #175156
  • open Reported problem #175391 since July 2, 2026 · 3 reactions · 10 comments · #175391
  • open Reported problem #181868 since September 10, 2026 · 1 reaction · 6 comments · #181868
  • open Reported problem #153891 since October 7, 2025 · 0 reactions · 24 comments · #153891
  • open Reported problem #168219 since April 14, 2026 · 0 reactions · 18 comments · #168219
  • open Reported problem #166046 since March 20, 2026 · 0 reactions · 7 comments · #166046
  • open Reported problem #175211 since June 30, 2026 · 0 reactions · 3 comments · #175211
  • open Reported problem #179876 since August 23, 2026 · 0 reactions · 2 comments · #179876

Fixed

Source: the issue tracker of Home Assistant, as of September 15, 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