---
id: pysmappee
version: "0.2.29"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pysmappee — Offical Smappee dev API and MQTT python wrapper

License: permissive · Maintenance: abandoned · Downloads: 73.7K/mo

## 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 above — verify before relying.

Wrapper library for the Smappee energy monitoring API (v3) and MQTT interface, enabling Python applications to query device data and control Smappee hardware.

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

pip install pysmappee
uv add pysmappee
poetry add pysmappee

## Installing pysmappee

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.

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()

Requires Python 3.7 or later. OAuth token from Smappee API required for authentication.

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_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 73.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

smappee api python, energy monitoring mqtt, smappee device control, home energy management api, mqtt energy data, smappee integration, python mqtt wrapper, energy-monitoring, mqtt, home-automation

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