⭐ Community-driven Tado integration with local control, smart analytics, and features you won't find anywhere else.
Built by the community, for the community — join thousands of users taking control of their smart climate.
Quick Start • Features • Configuration • Troubleshooting • Discussions
Tado CE turns your Tado system into a truly local smart climate platform. By pairing your Tado Internet Bridge via HomeKit, temperature and humidity updates arrive in real time over your local network — no cloud round-trip needed. Your heating keeps working even when Tado's servers are down, and local commands don't count against your API quota.
In real-world testing with 9 heating zones, HomeKit local control reduced daily API usage by over 80% (from ~394 calls/day to under 80) while delivering fresher data — temperature changes appear in about 1 second instead of waiting up to 5 minutes for the next cloud poll. During a simulated cloud outage, all 9 zones continued reporting live data with zero interruption.
If Tado ever drops the API limit to 100 calls/day, HomeKit users barely notice — temperatures stay real-time and you've got plenty of API budget left for cloud-only data like schedules and geofencing. Without HomeKit, 100 calls means your dashboard shows temperatures that could be 15–20 minutes old.
Beyond local control, Tado CE provides actionable insights that tell you what's wrong and what to do about it, thermal analytics that learn how your rooms heat, preheat advisors that prevent temperature drops before they happen, mold risk monitoring, multi-home support, and enhanced controls the official integration doesn't offer.
Prerequisites: Home Assistant 2025.11+ and a Tado account with V2/V3/V3+ devices.
- Click the button above (or add
https://github.com/hiall-fyi/tado_ceas a custom repository in HACS) - Install "Tado CE" from HACS
- Restart Home Assistant
Manual Installation
cp -r tado_ce /config/custom_components/- Go to Settings > Devices & Services > Add Integration
- Search for Tado CE and click Submit
- Click the authorization link shown, or visit the URL displayed and enter the code
- Authorize in your browser, then click Submit
- If you have multiple homes, select which one to use
That's it! No SSH required.
Check Settings > System > Logs for:
Tado CE: Integration loading...
Tado CE: Polling interval set to 30m (day)
Tado CE full sync SUCCESS
Tado CE: Integration loaded successfully
Click the gear icon on the integration card to customize features, polling schedule, and Smart Comfort settings.
Full climate, AC, and hot water control with timer support, geofencing, presence detection, weather data, and more.
Tado CE Exclusive:
Tado CE provides comprehensive smart climate control with features developed by and for the community:
- Local Control (HomeKit) — Pair your v3+ bridge via HomeKit for local temperature reads and writes over your LAN. Your heating keeps working when Tado's cloud is down, local commands don't count against your API quota, and temperature updates arrive in ~1 second instead of waiting for the next cloud poll. Everything falls back to cloud automatically if the local connection drops.
- Multi-Home Support — Multiple Tado accounts/homes in a single HA instance with full data isolation
- Actionable Insights — Per-zone and home-wide intelligent recommendations with priority escalation, correlation/deduplication, history tracking, health score, and 21+ insight types across 7 categories
- API Management — Real-time rate limit tracking, reset time detection, call history, sync monitoring
- Smart Polling — Adaptive real-time polling based on remaining API quota, custom intervals, monitoring sensors
- API Write Optimization — Smart debounce, redundant call skipping, device operation queuing, write coalescing, and schedule resume guard to reduce unnecessary API calls
- Environment Monitoring — Mold risk assessment, comfort level tracking, condensation risk (AC)
- Smart Comfort — Historical patterns, preheat advisor with cooling rate prediction, schedule sensors, AI recommendations
- Thermal Analytics — Heating rate analysis, preheat estimates, thermal inertia, confidence scoring
- Weather Compensation — Automatic boiler flow temperature adjustment based on outdoor temperature with preset heating curves
- Enhanced Controls — Smart boost, hot water timer (min 1 min), immediate refresh, temperature offset, restore previous state
- Smart Valve Control — Per-zone proportional TRV offset using external sensors. Automatically adjusts the TRV target so the room reaches your desired temperature, writing via HomeKit (zero API cost) with cloud fallback. Backs off on manual changes, resumes on next schedule block.
- Per-Zone Configuration — Individual overlay modes, temperature limits, UFH settings, Smart Valve Control per zone
- Zone Features Toggles — Control which entity types are created for a minimal or full setup
- Multi-Language — Config flow and options UI in 7 languages (English, German, Spanish, French, Italian, Dutch, Portuguese)
- Optional Features — Schedule calendar, boiler flow temperature, device tracking, home state sync
Every feature requested, tested, and refined by real users like you.
See FEATURES_GUIDE.md for detailed documentation, configuration instructions, and usage scenarios for all features.
Access via Settings > Devices & Services > Tado CE > gear icon.
Settings are organised into four sections:
- General Settings — Feature toggles (Weather, Mobile Tracking, Smart Comfort, Schedule Calendar, Zone Features, Bridge, Weather Compensation, Local Control)
- Advanced Settings — Tuning parameters for enabled features only (polling intervals, debounce windows, comfort modes, heating curves, HomeKit cloud sync frequency)
- Zone Configuration — Per-zone overlay mode, temperature limits, heating type, external sensors, window detection, preheat mode, Smart Valve Control
- Reset to Defaults — Reset settings per feature or everything at once, without losing your Tado account or bridge pairing
See FEATURES_GUIDE.md for detailed configuration guides and usage scenarios based on your setup (low quota, high quota, mixed zones, OpenTherm boiler, etc.).
Note: Changes take effect immediately without restart.
Quick overview of entities created by Tado CE (88 entity types — see ENTITIES.md for full reference):
- Hub: API usage/reset/sync sensors, weather sensors, home insights, presence mode, overlay mode, resume all button
- Per Zone: Climate control, temperature/humidity, heating power, overlay status, battery, connection
- Environment: Mold risk, comfort level, surface temperature, dew point, condensation risk (AC)
- Actionable Insights: Per-zone insights + home-wide aggregation with correlation, history tracking, priority escalation, and health score
- Smart Comfort: Heating/cooling rates, time-to-target, preheat advisor (with cooling rate prediction), schedule sensors (opt-in)
- Thermal Analytics: Thermal inertia, heating rate, preheat time, confidence scoring (heating zones)
- Hot Water: Water heater with AUTO/HEAT/OFF modes, timer buttons (min 1 min)
- Weather Compensation: Target flow temperature, compensation status (when bridge configured)
- Switches: Child lock, early start per zone
- Zone Features Toggles: Control which entity types are created for a minimal or full setup
10 services for climate control, hot water timers, open window mode, temperature offsets, and more. All available in Developer Tools > Services with full parameter documentation.
See FEATURES_GUIDE.md for service details and usage examples.
Tado CE automatically adjusts how often it checks the cloud based on your remaining API quota. Works for any quota tier (100, 1000, 20,000) — no configuration needed. With HomeKit connected, cloud polling drops further since temperature and humidity come locally.
You can override with custom day/night intervals in Configure > Advanced Settings > Polling & API.
See FEATURES_GUIDE.md for polling details, quota tiers, and monitoring sensors.
| Device | Type | Support | HomeKit Local |
|---|---|---|---|
| Smart Thermostat V2 | HEATING | Full (community verified) | ❌ (V2 bridge) |
| Smart Thermostat V3/V3+ | HEATING | Full | ✅ |
| Smart Radiator Thermostat (SRT/VA02) | HEATING | Full | ✅ |
| Smart AC Control V3/V3+ | AIR_CONDITIONING | Full | ✅ (temp only) |
| Wireless Temperature Sensor | HEATING | Full | ❌ (not a HomeKit accessory) |
| Internet Bridge V3+ | Infrastructure | N/A | Required for local control |
| Tado X Series | Matter/Thread | Not Supported | — |
Tado X devices use Matter over Thread - use the Home Assistant Matter integration instead.
See Known Limitations in the Features Guide.
- Go to Settings > Devices & Services > Tado CE
- Click the three-dot menu (⋮) and select Delete
- Restart Home Assistant
- If installed via HACS: open HACS > Integrations, find Tado CE, click the three-dot menu and Remove
- If installed manually: delete the
custom_components/tado_ce/folder - Restart Home Assistant again
Token refresh failed / Re-authentication required
- Go to Settings > Devices & Services > Tado CE
- Click Configure or look for re-authentication prompt
- Follow the device authorization flow (link + code)
No device tracker entities
Device trackers only appear for mobile devices with geo tracking enabled in the Tado app.
Enable debug logging
Add to configuration.yaml:
logger:
default: info
logs:
custom_components.tado_ce: debugRestart Home Assistant and check Settings > System > Logs.
For other issues, check logs at Settings > System > Logs (filter by "tado_ce") or open an issue on GitHub.
Bridge API sensors showing "Unknown"
Wrong data path (fixed in v3.2.2), bridge credentials invalid, or bridge offline.
Solution:
- Update to v3.2.2+
- Verify credentials in Configure → Bridge Configuration
- Check bridge is online
- Enable debug logging:
logger:
default: info
logs:
custom_components.tado_ce.bridge_api: debug
custom_components.tado_ce.sensor_bridge: debugLook for Bridge API full response in logs to verify the API is returning data.
| Document | Description |
|---|---|
| FEATURES_GUIDE.md | Complete guide to all features, sensors, configuration, and usage scenarios |
| ENTITIES.md | Complete list of all sensors, switches, and controls |
| API_REFERENCE.md | API call types, optimization tips, troubleshooting |
| ROADMAP.md | Planned features, ideas, and known limitations |
| CREDITS.md | Community contributors and supporters |
| CHANGELOG.md | Version history and release notes |
GNU Affero General Public License v3.0 (AGPL-3.0)
Free to use, modify, and distribute. Modifications must be open source under AGPL-3.0 with attribution.
Original Author: Joe Yiu (@hiall-fyi)
See LICENSE for full details.
Join the community that's shaping the future of smart climate control!
Contributions welcome! Every feature in Tado CE started as a community idea.
- Fork the repository
- Create feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Your ideas matter — check out our Discussions to share feature requests, ask questions, or help other users.
Disclaimer
This project is not affiliated with, endorsed by, or connected to tado GmbH or Home Assistant. tado and the tado logo are registered trademarks of tado GmbH. Home Assistant is a trademark of Nabu Casa, Inc.
This integration is provided "as is" without warranty. Use at your own risk.
