switchbot-api
An asynchronous library to use Switchbot API
Decision gist · record as of 2026-08-14
Yes. The library is actively maintained, has low install friction, carries a permissive MIT license, and has no known vulnerabilities. It fills a clear niche for Python developers integrating SwitchBot devices into automation workflows. The async design aligns with modern Python practices. Install it if you're building SwitchBot automation.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Caller must provide valid SwitchBot API token and secret, and must use async/await context.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both personal and commercial projects.
last release 2026-08-10 (4 days) · last repo commit 2026-08-10 · 6 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 73,438 downloads/mo, #14,999 on PyPI
Alternatives
Verify before relying
pip install switchbot-api
from switchbot_api import SwitchBotAPI
client = SwitchBotAPI(token="xxx", secret="yyy")
devices = await client.list_devices()
status = await client.get_status('some-id')
await client.send_command('some-id', {COMMAND})- Whether the library handles token/secret rotation or refresh automatically, or if caller must manage credentials.
- Rate limiting behavior and retry logic when calling the SwitchBot API.
- Whether error handling distinguishes between network failures, authentication failures, and device-specific errors.
What it is and what it does
switchbot-api is an async Python client for the official SwitchBot API, letting you query, monitor, and control SwitchBot devices and remotes from Python code. It wraps the REST API with async/await patterns, handling the cryptographic signing required by SwitchBot's authentication scheme through pycryptodome and managing HTTP requests via aiohttp.
The library is designed for home automation and IoT integration scenarios where you need to programmatically list devices, check their status, or send commands. It's actively maintained, supports modern Python versions (3.10–3.14), and has no known security vulnerabilities. Installation is straightforward with a pure-Python wheel and only two runtime dependencies.
Use it for
- Build a home automation dashboard that queries SwitchBot device status and sends control commands asynchronously.
- Integrate SwitchBot devices into a larger smart-home orchestration system via REST API calls.
- Create scheduled or event-driven automation workflows that toggle SwitchBot remotes or devices based on external triggers.
- Monitor SwitchBot device state in real-time for logging, alerting, or analytics purposes.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The library is actively maintained, has low install friction, carries a permissive MIT license, and has no known vulnerabilities. It fills a clear niche for Python developers integrating SwitchBot devices into automation workflows. The async design aligns with modern Python practices. Install it if you're building SwitchBot automation.
Install
switchbot-api on PyPI
Before you install
Low install friction with a pure-Python wheel. Actively maintained as of 2026-08-10 with recent releases. Supports current Python versions (3.10–3.14).
Requires Python 3.10 or later. Caller must provide valid SwitchBot API token and secret, and must use async/await context.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both personal and commercial projects.
Quickstart
pip install switchbot-api
from switchbot_api import SwitchBotAPI
client = SwitchBotAPI(token="xxx", secret="yyy")
devices = await client.list_devices()
status = await client.get_status('some-id')
await client.send_command('some-id', {COMMAND})Verify before relying
- Whether the library handles token/secret rotation or refresh automatically, or if caller must manage credentials.
- Rate limiting behavior and retry logic when calling the SwitchBot API.
- Whether error handling distinguishes between network failures, authentication failures, and device-specific errors.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesaiohttppycryptodome |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 73,438 / month, #14,999 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: switchbot_api-2.13.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “switchbot api client”
- switchbot-apiAn async Python library for controlling SwitchBot devices and remotes…
- PySwitchbotAsync Python library to discover and control Switchbot IoT devices…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also elmax-api · factorio-rcon-py · pyControl4 · PySwitchbot · pylitterbot · aioruckus · seam · meross-iot · deebot-client · wled