---
id: home-connect-async
version: "0.8.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# home-connect-async — Async SDK for BSH Home Connect API

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

## What it is and what it does

home-connect-async is a high-level async Python client for the BSH Home Connect API, which controls and monitors home appliances sold under Bosch, Siemens, Gaggenau, and Neff branding. It abstracts the OAuth2 authentication flow and REST API calls into a data model, then maintains a live-updating state by subscribing to real-time events from the API—so you can start a washer cycle and receive notifications when it completes, all without polling.

The package is built on aiohttp for async HTTP, aiohttp-sse-client for server-sent events, oauth2-client for credential handling, and dataclasses-json for serialization. It's actively maintained, carries no known vulnerabilities, and is licensed under MIT. The main prerequisite is registering a developer account at https://developer.home-connect.com to obtain OAuth2 credentials.

Use it for:

- Start or stop appliance programs (e.g., washing machine cycles) and receive completion notifications.
- Monitor real-time appliance status and settings without polling the API.
- Build a home automation dashboard that displays and controls multiple BSH appliances.
- Integrate BSH appliances into a broader smart-home orchestration system.
- Log appliance events and energy usage for analytics or billing purposes.

## Worth the install?

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

An async Python SDK that connects to the BSH Home Connect API to monitor and control home appliances from brands like Bosch, Siemens, Gaggenau, and Neff, maintaining real-time state through subscriptions.

Yes. The package is actively maintained, has low install friction, carries no security vulnerabilities, and solves a specific problem—async control and monitoring of BSH Home Connect appliances—with a clean API. The main requirement is obtaining developer credentials from Home Connect; if you own compatible appliances and need programmatic access, this is the right tool.

## Install

pip install home-connect-async
uv add home-connect-async
poetry add home-connect-async

## Installing home-connect-async

Before you install: Low install friction with a pure-wheel distribution. Actively maintained with a recent release (90 days ago) and ongoing commits. Five runtime dependencies are all well-established async/HTTP libraries.

License in practice: MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, only requiring attribution and inclusion of the license notice.

Quickstart:

pip install home-connect-async

import asyncio
from home_connect_async import HomeConnectClient

async def main():
    client = HomeConnectClient(client_id, client_secret, redirect_uri)
    await client.authenticate()
    appliances = await client.get_appliances()

asyncio.run(main())

Requires a registered Home Connect developer account and OAuth2 credentials (client ID, secret, redirect URI) from https://developer.home-connect.com.

Verify before relying:

- Whether the SDK supports all BSH appliance types or only a subset of Home Connect-enabled models.
- Specific Python version requirements (classifiers list 3.12–3.14 but requires_python is unspecified).
- Whether real-time subscription updates work reliably across all network conditions or have known limitations.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 84.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

home connect api sdk, bosch appliance control, async home automation, bsh home connect python, smart appliance monitoring, home connect real-time updates, appliance control sdk, home-automation, iot-sdk, async-http

[View on SkillFed](https://skillfed.io/packages/home-connect-async) · [View on PyPI](https://pypi.org/project/home-connect-async/)