---
title: "SwitchBot Cloud"
description: "SwitchBot Cloud is a built-in integration for Home Assistant. It has 11.7k installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/switchbot-cloud"
url: "https://vulpo.app/integrations/core/switchbot-cloud.md"
last-updated: "2026-10-22"
version: "1.4"
---

# SwitchBot Cloud

> SwitchBot Cloud is a built-in integration for Home Assistant. It has 11.7k installs sharing analytics and needs the vendor's cloud.

SwitchBot Cloud is a built-in integration that connects SwitchBot devices to Home Assistant through the vendor's cloud. It exposes devices as binary sensors, buttons, climate, covers, fans, humidifiers, images, lights, locks, selects, sensors, switches and vacuums. Some devices get specific controls, such as next and previous buttons, a night light selector, and sensors for light level and lock state. An image entity shows the display of a device, and an action uploads web images to the AI Art Frame. Setup happens in the UI and asks for an API key and API token.

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_cloud)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **API key**
- **API token**

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Buttons**: Next, Previous
- **Images**: Display
- **Selects**: Night light
- **Sensors**: Light level, Lock state

## Actions

- **Upload AI Art Frame image**: Upload web images to the device.
  Fields: Devices, Image URL

## At a glance

- Kind: Built-in integration
- Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Smart home hubs
- Brand: [SwitchBot](https://vulpo.app/integrations/switchbot.md)
- Number: 11.7k installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `switchbot_cloud`
- Source: <https://www.home-assistant.io/integrations/switchbot_cloud/>

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 Bluetooth](https://vulpo.app/integrations/core/switchbot.md) | Built-in integration | 24.6k installs sharing analytics | Works locally | 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-cloud

---

- HTML version of this page: https://vulpo.app/integrations/core/switchbot-cloud
- 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