---
id: python-tado
version: "0.19.2"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# python-tado — PyTado from chrism0dwk, modified by w.malgadey, diplix, michaelarnauts, LenhartStephan, splifter, syssi, andersonshatch, Yippy, p0thi, Coffee2CodeNL, chiefdragon, FilBr, nikilase, albertomontesg, Moritz-Schmidt, palazzem

License: copyleft · Maintenance: active · Downloads: 76.8K/mo

## What it is and what it does

python-tado is a Python wrapper around the Tado heating system API that lets you read and control your smart thermostat beyond what Tado's official app provides. It handles the OAuth2 device-flow authentication (as of March 2025) and manages token refresh automatically. The package depends only on requests and is designed for developers who want to build custom automation, monitoring, or integration layers on top of their Tado heating setup.

The library exposes methods to check device activation status, retrieve zones, and interact with the heating system. It supports token persistence so you don't have to re-authenticate on every run. The project is actively maintained, supports modern Python versions (3.11 or later), and has no known security vulnerabilities. It's classified as Beta and intended for developers comfortable with experimental software.

Use it for:

- Build a custom home automation dashboard that pulls live heating data and displays it alongside other smart home metrics
- Create heating optimization logic that adjusts temperatures based on occupancy, weather, or time-of-day patterns
- Integrate heating control into a broader home assistant setup or third-party smart home platform
- Monitor heating system performance over time and generate reports on energy usage and comfort patterns
- Trigger heating adjustments from external events like door sensors or outdoor temperature changes

## Worth the install?

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

PyTado provides a Python interface to the Tado web API, allowing you to monitor and control your Tado heating system programmatically beyond the official app's capabilities.

Yes, if you own a Tado system and want programmatic control or integration with custom automation. The package is actively maintained, has low install friction, and carries no security vulnerabilities. The GPL-3.0-or-later license is a blocker only if you need to use it in a proprietary application. The device-flow authentication adds a one-time setup step but is well-documented.

## Install

pip install python-tado
uv add python-tado
poetry add python-tado

## Installing python-tado

Before you install: Low install friction with a single runtime dependency (requests). The project is actively maintained with recent commits and a stable release history since 2017. Requires Python 3.11 or later.

License in practice: Licensed under GPL-3.0-or-later (copyleft). Any application using this package must also be distributed under a compatible open-source license; proprietary or closed-source projects cannot use it without relicensing.

Quickstart:

pip install python-tado

from python_tado.interface.interface import Tado

tado = Tado(token_file_path="/var/tado/refresh_token")
if tado.device_activation_status() == "PENDING":
    tado.device_activation()
zones = tado.get_zones()
print(zones)

Tado OAuth2 device-flow authentication requires browser access and manual code entry during initial setup. Requires Python 3.11 or later.

Verify before relying:

- Whether the package supports Tado systems outside specific regions or hardware generations
- Rate limits or throttling behavior when polling the Tado API
- Whether token refresh happens transparently or requires manual intervention in long-running applications

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tado heating api python, smart thermostat control, home heating automation, tado device integration, heating system monitoring, iot heating control, tado api wrapper, home-automation, iot-integration, heating-control

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