---
id: homematicip
version: "2.15.0"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# homematicip — An API for the homematicip cloud

License: copyleft · Maintenance: active · Downloads: 85.8K/mo

## What it is and what it does

homematicip is a Python wrapper around the HomematicIP REST API, built through reverse engineering since no official documentation exists. It provides programmatic control and monitoring of HomematicIP smart home devices—thermostats, locks, blinds, switches, and sensors—connected through a HomematicIP access point. The library handles authentication, WebSocket connections for real-time updates, and HTTP requests to read device state and send commands.

The package is designed for developers building home automation integrations or dashboards that need to interact with HomematicIP hardware. It includes a CLI tool (hmip_cli) for common operations like listing devices, toggling actuators, and listening to events, and a token-generation utility for initial setup. The library supports a large range of HomematicIP device models, though some newer variants remain unimplemented.

Use it for:

- Build a custom dashboard or mobile app that displays and controls your HomematicIP devices in real time
- Automate heating schedules by programmatically adjusting thermostat setpoints based on external conditions
- Integrate HomematicIP with other home automation platforms or trigger actions based on device events
- Monitor door locks, blinds, and switches remotely and log their state changes for audit or analytics
- Create scene-like automations that coordinate multiple devices (e.g., lock doors and close blinds on departure)

## Worth the install?

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

A Python wrapper for the HomematicIP REST API that lets you control and monitor HomematicIP smart home devices through an access point, communicating via HTTP and WebSocket connections.

Yes, with conditions. Install if you own HomematicIP hardware and need programmatic control or integration with other systems. The library is actively maintained, has no known vulnerabilities, and low install friction. However, be aware that it relies on reverse-engineered API knowledge (not official documentation), so firmware updates could break compatibility. The GPL-3.0-or-later license means you cannot use this in closed-source commercial products without an alternative license agreement.

## Install

pip install homematicip
uv add homematicip
poetry add homematicip

## Installing homematicip

Before you install: Low install friction with a pure-Python wheel and four common HTTP/WebSocket dependencies. Active maintenance with a recent commit on 2026-08-14 and no known vulnerabilities.

License in practice: Licensed under GPL-3.0-or-later (copyleft). Any derivative work or distribution must also be open-source under a compatible license; proprietary applications cannot use this package without obtaining an alternative license.

Quickstart:

pip install homematicip

from homematicip.home import Home

home = Home()
await home.get_current_state()

Requires Python 3.12 or later. You must generate an authentication token via hmip_generate_auth_token CLI before connecting to your HomematicIP access point.

Verify before relying:

- Whether the reverse-engineered API remains stable across HomematicIP firmware updates
- Real-world compatibility with all listed device models beyond what the maintainer has tested
- Performance characteristics when managing large numbers of devices or frequent polling

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

homematicip api wrapper, smart home device control, homematicip cloud integration, home automation python, iot device management, homematicip rest client, smart thermostat control, home-automation, iot, rest-api-client

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