---
id: maxcube-api
version: "0.4.3"
license: Type license() to see the full license text
license_treatment: unclear
maintenance: dormant
---

# maxcube-api — eQ-3/ELV MAX! Cube Python API

License: unclear · Maintenance: dormant · Downloads: 73.4K/mo

## What it is and what it does

maxcube-api is a Python library for communicating with eQ-3/ELV MAX! Cube thermostats via network protocol. It was originally built to support Home Assistant integration and exposes basic operations: querying cube metadata, listing connected thermostat devices, reading their modes and temperatures, and saving or restoring thermostat programs to JSON.

The package has no external runtime dependencies and requires Python 3.7 or later. It is dormant since its last release in May 2021, but the underlying repository remains minimally maintained. It is suitable for home automation scenarios where you already own MAX! hardware and need programmatic control, but should be considered stable rather than actively developed.

Use it for:

- Retrieve current room temperature and thermostat mode from MAX! devices for home automation dashboards.
- Back up and restore thermostat heating programs to JSON files for disaster recovery or device migration.
- Integrate MAX! Cube control into home automation platforms.
- Monitor multiple MAX! thermostats across a home network and log temperature data over time.

## Worth the install?

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

Provides a Python API to query and control eQ-3/ELV MAX! Cube thermostats over the network, retrieving device status, temperatures, and modes.

Yes, if you own MAX! Cube hardware and need programmatic control—low install friction, no dependencies, and no known vulnerabilities. No, if you are looking for active development or support; the package is dormant since 2021. Verify the unclear license before use in commercial projects.

## Install

pip install maxcube-api
uv add maxcube-api
poetry add maxcube-api

## Installing maxcube-api

Before you install: Low install friction with no runtime dependencies. Maintenance is dormant—last release was in May 2021, though the repository remains active with a recent commit in June 2024. Suitable for stable use cases but expect no active development.

License in practice: License treatment is unclear; the package metadata does not specify an SPDX identifier or standard license type. Verify the actual license text before using in proprietary or commercial projects.

Quickstart:

from maxcube.cube import MaxCube

cube = MaxCube('192.168.0.20')
for device in cube.devices:
    print(device.name, device.actual_temperature)

Requires network access to a MAX! Cube device on the local network; no simulation or mock mode documented.

Verify before relying:

- Whether the unclear license permits commercial or proprietary use without restrictions
- Compatibility with current MAX! Cube hardware versions and firmware releases

## Package facts

- License: Type license() to see the full license text (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 73.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

max cube thermostat control, eQ-3 MAX thermostat API, smart thermostat python library, home automation thermostat, MAX cube network control, thermostat device monitoring, home-automation, iot-devices

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