pysmappee
Offical Smappee dev API and MQTT python wrapper
Decision gist · record as of 2026-08-14
No—not for new projects. The package is abandoned (last release 2021-12-07, last commit 2022-08-30) and will not receive updates for API changes, new hardware support, or Python version compatibility. If you are already using it in Home Assistant or a legacy system, it remains stable and has no known vulnerabilities. For new integrations, check whether Home Assistant or the Smappee community maintains a more recent fork.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.7 or later.
- OAuth token from Smappee API required for authentication.
- Low install friction with a pure-wheel distribution and six common dependencies.
License · maintenance · safety
MIT (permissive) — MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.
last release 2021-12-07 (1711 days) · last repo commit 2022-08-30 · 2 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 73,690 downloads/mo, #14,948 on PyPI
Alternatives
Verify before relying
pip install pysmappee
from pysmappee import SmappeeClient
client = SmappeeClient(token='your_oauth_token')
locations = client.get_locations()- Whether the Smappee API v3 endpoint is still operational and compatible with current Smappee hardware.
- Current state of MQTT support for Smappee Genius and other recent device models.
- Whether Home Assistant still uses this package or has migrated to a maintained fork.
What it is and what it does
PySmappee is an official Python wrapper around the Smappee energy monitoring platform's REST API (v3) and MQTT interface. It abstracts authentication, device discovery, and data polling, allowing developers to query energy consumption and production data, control smart plugs and actuators, and receive real-time updates via MQTT. The library is primarily used as a dependency in Home Assistant's Smappee integration.
The package depends on requests, requests-oauthlib for OAuth2 authentication, paho-mqtt for message broker communication, cachetools for caching, pytz for timezone handling, and schedule for polling tasks. It targets Python 3.7+ and is distributed as a pure wheel with low installation friction.
Use it for
- Integrate Smappee energy data into a home automation system to monitor real-time consumption and solar production.
- Build a custom dashboard that polls Smappee devices via the REST API and displays historical energy trends.
- Subscribe to MQTT topics from a local Smappee Genius device to trigger automations based on power thresholds.
- Control Smappee comfort plugs and actuators programmatically from a Python application.
- Fetch location and device metadata to synchronize Smappee hardware inventory with an external system.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—not for new projects.
The package is abandoned (last release 2021-12-07, last commit 2022-08-30) and will not receive updates for API changes, new hardware support, or Python version compatibility. If you are already using it in Home Assistant or a legacy system, it remains stable and has no known vulnerabilities. For new integrations, check whether Home Assistant or the Smappee community maintains a more recent fork.
Install
pysmappee on PyPI
Before you install
Low install friction with a pure-wheel distribution and six common dependencies. However, the package is abandoned—last commit was 2022-08-30 and no release since 2021-12-07. Security risk is minimal (no known vulnerabilities), but bug fixes and compatibility updates will not arrive.
Requires Python 3.7 or later. OAuth token from Smappee API required for authentication.
License in practice
MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.
Quickstart
pip install pysmappee
from pysmappee import SmappeeClient
client = SmappeeClient(token='your_oauth_token')
locations = client.get_locations()Verify before relying
- Whether the Smappee API v3 endpoint is still operational and compatible with current Smappee hardware.
- Current state of MQTT support for Smappee Genius and other recent device models.
- Whether Home Assistant still uses this package or has migrated to a maintained fork.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagescachetoolspaho-mqttpytzrequestsrequests-oauthlibschedule |
| Maintenance | Abandoned 1,711 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 73,690 / month, #14,948 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: pysmappee-0.2.29-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 › “smappee api python”
- pysmappeeWrapper library for the Smappee energy monitoring API (v3) and MQTT…
- xdkA Python SDK for interacting with the X API, providing typed client…
- sailthru-clientA Python client library for the Sailthru REST API, enabling remote…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also pysma · sense-energy · pysml · pysensibo · p1monitor · tb-mqtt-client · victron-mqtt · ovoenergy · tuya-device-sharing-sdk · meross-iot