python-tado

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 on this page — 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

python-tado on PyPI

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

Evidence: python_tado-0.19.2-py3-none-any.whl

Keywords: tado

Tags

More Home Automation packages