---
id: aiowithings
version: "3.1.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# aiowithings — Asynchronous Python client for Withings.

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

## What it is and what it does

aiowithings is an asynchronous Python client library for interacting with the Withings API, enabling developers to programmatically fetch health and fitness data from Withings devices. It wraps HTTP requests using aiohttp and yarl, providing a non-blocking interface suitable for concurrent applications.

The package is designed for developers integrating Withings data into Python applications—home automation systems, health dashboards, or data analysis pipelines. It follows semantic versioning and is actively maintained, supporting Python 3.11, 3.12, and 3.13. The MIT license makes it freely usable in both open-source and proprietary projects.

Use it for:

- Fetch weight, heart rate, or sleep data from Withings devices into a home automation or health-tracking dashboard.
- Integrate Withings health metrics into a data pipeline for personal analytics or research.
- Build a concurrent service that polls multiple Withings accounts asynchronously without blocking.
- Sync Withings device data to a database or third-party health platform on a scheduled basis.
- Develop a bot or notification system that reacts to Withings measurements in real time.

## Worth the install?

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

Asynchronous Python client for fetching data from Withings health and fitness devices via their API.

Yes. The package has low install friction, active maintenance, no known vulnerabilities, and a permissive MIT license. Install it if you need to programmatically access Withings API data from Python; the async design makes it well-suited for concurrent or event-driven applications. Verify that its authentication model and supported data types match your use case before committing.

## Install

pip install aiowithings
uv add aiowithings
poetry add aiowithings

## Installing aiowithings

Before you install: Low install friction with only two runtime dependencies (aiohttp and yarl). Actively maintained with recent commits and a stable release cadence following semantic versioning.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install aiowithings

import asyncio
from aiowithings import WithingsClient

async def fetch_data():
    client = WithingsClient(access_token='your_token')
    # Use client methods to fetch Withings data
    await client.close()

asyncio.run(fetch_data())

Requires Python 3.11 or later; Withings API credentials (access token) needed to authenticate requests.

Verify before relying:

- Whether the package supports OAuth2 authentication or requires pre-configured API credentials
- What specific Withings data types (weight, heart rate, sleep, etc.) the client can retrieve
- Whether rate limiting or pagination is handled automatically by the client

## Package facts

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

## Tags

withings api client, async withings data, withings health device integration, python withings client, withings health tracking api, async health device api, withings fitness data fetch, async-http-client, health-api, iot-integration

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