---
id: pysmartthings
version: "4.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pysmartthings — Asynchronous Python client for SmartThings.

License: permissive · Maintenance: active · Downloads: 82.8K/mo

## What it is and what it does

pysmartthings is an async-first Python client library for the SmartThings API, designed to let you query and manage SmartThings devices and automations from Python code. It wraps HTTP calls to SmartThings' REST endpoints using aiohttp for non-blocking I/O, making it suitable for integration into async applications, home automation frameworks, and event-driven systems.

The package depends on aiohttp for HTTP transport, mashumaro and orjson for efficient data serialization, and yarl for URL handling. It targets modern Python (3.13+) and is actively maintained with a stable API surface. You would use it when you need programmatic access to SmartThings data in an async context—for example, polling device state, triggering automations, or building a bridge between SmartThings and another system.

Use it for:

- Fetch current state of SmartThings devices (lights, locks, thermostats) in an async application
- Build a home automation dashboard that queries SmartThings for real-time device status
- Integrate SmartThings with another home automation platform or custom orchestration system
- Monitor device events and trigger external actions based on SmartThings state changes
- Develop a bot or service that controls SmartThings devices via API calls

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python client for fetching data from and interacting with SmartThings devices and services via their API.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and fills a clear need for async SmartThings API access in Python. It supports current Python versions and has no known vulnerabilities. Install it if you need to integrate SmartThings into an async Python application.

## Install

pip install pysmartthings
uv add pysmartthings
poetry add pysmartthings

## Installing pysmartthings

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a release 70 days ago and recent commits; requires Python 3.13 or later.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install pysmartthings

import aiohttp
from pysmartthings import SmartThings

async with aiohttp.ClientSession() as session:
    api = SmartThings(session, token='your_token')
    devices = await api.devices()

Requires Python 3.13 or later; requires an active SmartThings API token for authentication.

Verify before relying:

- Specific SmartThings API endpoints and device types supported by version 4.0.1
- Whether rate limiting or throttling is built in or handled by the caller
- Authentication flow details and token management patterns

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 82.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

smartthings api client, async smartthings python, smartthings device control, home automation smartthings, smartthings integration, async iot client, smartthings data fetch, home-automation, async-io, smartthings-api

[View on SkillFed](https://skillfed.io/packages/pysmartthings) · [View on PyPI](https://pypi.org/project/pysmartthings/)