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
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Tado OAuth2 device-flow authentication requires browser access and manual code entry during initial setup.
- Requires Python 3.11 or later.
- Low install friction with a single runtime dependency (requests).
License · maintenance · safety
GPL-3.0-or-later (copyleft) — 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.
last release 2025-04-03 (498 days) · last repo commit 2026-08-03 · 107 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 76,842 downloads/mo, #14,588 on PyPI
Alternatives
Verify before relying
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)- 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
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 on it.
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
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.
Tado OAuth2 device-flow authentication requires browser access and manual code entry during initial setup. 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)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 the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagerequests |
| Maintenance | Actively maintained 498 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 76,842 / month, #14,588 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: GNU General Public License v3 (GPLv3)License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)Natural Language :: EnglishProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Home Automation |
Evidence: python_tado-0.19.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tado heating api python”
- python-tadoPyTado provides a Python interface to the Tado web API, allowing you…
- PyViCarePyViCare provides Python access to Viessmann heating devices through…
- python-bsblanAsynchronous Python client for controlling and monitoring BSBLan…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also pyotgw · myPyllant · pyatag · python-bsblan · millheater · tinytuya · devolo-home-control-api · wled · AEMET-OpenData · homematicip