---
id: python-ecobee-api
version: "0.4.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-ecobee-api — Python API for talking to Ecobee thermostats

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

## What it is and what it does

python-ecobee-api is a lightweight Python wrapper for the Ecobee thermostat API, enabling programmatic control and monitoring of Ecobee3 wifi-enabled thermostats. It abstracts the HTTP communication layer through its single runtime dependency, requests, making it straightforward to integrate thermostat control into automation workflows.

The library is actively maintained and designed with Home Assistant integration in mind, though it can be used independently. With no known security vulnerabilities and a permissive MIT license, it presents a low-friction option for developers building home automation systems or custom integrations around Ecobee hardware.

Use it for:

- Integrate Ecobee thermostat control into Home Assistant automation workflows
- Build custom home automation scripts to adjust temperature based on external conditions
- Monitor thermostat status and occupancy data from a Python application
- Create scheduled temperature adjustments without using the Ecobee mobile app

## Worth the install?

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

A Python library for communicating with Ecobee3 wifi thermostats via their API, primarily designed for use with Home Assistant.

Yes, if you own an Ecobee3 thermostat and need programmatic control. The low install friction, active maintenance, permissive license, and lack of known vulnerabilities make it a sound choice. Verify Python version compatibility and API credential requirements before integrating into production systems.

## Install

pip install python-ecobee-api
uv add python-ecobee-api
poetry add python-ecobee-api

## Installing python-ecobee-api

Before you install: Low install friction with a single dependency on requests. Actively maintained with a recent release as of 2026-05-29 and ongoing commits.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both personal and commercial projects.

Quickstart:

pip install python-ecobee-api

import python_ecobee_api
# Initialize with Ecobee API credentials and interact with thermostat

Requires valid Ecobee API credentials and an active Ecobee account with a compatible thermostat

Verify before relying:

- Specific Ecobee API endpoints and authentication methods supported by this version
- Whether the library supports Ecobee models beyond Ecobee3
- Python version compatibility (requires_python is unspecified)
- Module and class names for initialization and thermostat interaction

## Package facts

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

## Tags

ecobee thermostat control, ecobee3 wifi api, home automation thermostat, ecobee python library, smart thermostat integration, ecobee device communication, home-automation, iot-integration

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