homematicip
An API for the homematicip cloud
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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.
- Low install friction with a pure-Python wheel and four common HTTP/WebSocket dependencies.
License · maintenance · safety
GPL-3.0-or-later (copyleft) — 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.
last release 2026-08-14 (0 days) · last repo commit 2026-08-14 · 239 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 85,751 downloads/mo, #13,899 on PyPI
Alternatives
Verify before relying
pip install homematicip
from homematicip.home import Home
home = Home()
await home.get_current_state()- 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
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 on this page. Verify before relying on it.
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
homematicip on PyPI
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.
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.
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()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 the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesrequestswebsocketsaiohttphttpx |
| Maintenance | Actively maintained 0 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 85,751 / month, #13,899 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3.12 |
Evidence: homematicip-2.15.0-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 › “homematicip api wrapper”
- homematicipA Python wrapper for the HomematicIP REST API that lets you control…
- aiohomematicAn async Python library for controlling and monitoring Homematic and…
- boschshcpyPython client library for the Bosch Smart Home Controller local REST…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also boschshcpy · jaraco.abode · elmax-api · pyoverkiz · venstarcolortouch · myPyllant · python-ecobee-api · ring-doorbell · python-fullykiosk · pyhiveapi