---
id: mypyllant
version: "0.9.18"
license: unclear
license_treatment: permissive
maintenance: active
---

# myPyllant — A Python library to interact with the API behind the myVAILLANT app

License: permissive · Maintenance: active · Downloads: 125.1K/mo

## What it is and what it does

myPyllant is an async Python client for the undocumented myVAILLANT API, letting you programmatically control and query Vaillant heating systems and their branded variants (MiGo, Glow-worm). It wraps aiohttp and pydantic to handle authentication, system discovery, and device operations like temperature setpoints, holiday modes, and hot water boosts. The library is reverse-engineered from the official app and not affiliated with Vaillant; the developers disclaim responsibility for device damage.

You can use it as a Python library in async code, or invoke it as a CLI tool to export system data and energy reports. It requires Python 3.10 and handles timezone-aware operations automatically. The package is actively maintained, with a small but engaged community and integration into Home Assistant.

Use it for:

- Export system configuration and historical data from your Vaillant heating setup for analysis or backup.
- Automate temperature adjustments and holiday schedules programmatically from a home automation platform.
- Generate annual energy reports for each heat generator in your system.
- Monitor and control domestic hot water boost and setpoint temperature remotely.
- Build a custom Home Assistant integration or other home automation bridge to Vaillant devices.

## Worth the install?

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

A Python library for interacting with the myVAILLANT app API to control and monitor Vaillant heating systems and their branded variants.

Yes, if you own a Vaillant system and need programmatic control or data export. The library is actively maintained, has low install friction, carries no security vulnerabilities, and is permissively licensed. The main caveat is that it reverse-engineers an undocumented API, so Vaillant could break it at any time; the developers explicitly disclaim responsibility for device damage. Test thoroughly in a non-critical environment first.

## Install

pip install mypyllant
uv add mypyllant
poetry add mypyllant

## Installing myPyllant

Before you install: Low friction installation with a pure-Python wheel. The package is actively maintained with a recent release (23 days old) and steady repository activity. Requires Python 3.10 or later.

License in practice: Licensed under MIT (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install myPyllant

import asyncio
from myPyllant.api import MyPyllantAPI

async def main():
    async with MyPyllantAPI(user, password, brand, country) as api:
        async for system in api.get_systems():
            print(system)

asyncio.run(main())

Requires Python 3.10 or later. On Windows and systems without a timezone database, also install tzdata.

Verify before relying:

- Whether the library works reliably with all branded variants (MiGo, Glow-worm) or only certain configurations.
- API stability and rate limits when making frequent requests to the myVAILLANT backend.
- Whether account credentials are safely handled and what security practices are recommended.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 125.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vaillant api client, myVAILLANT integration, heating system control python, vaillant device management, home automation heating, HVAC system api, smart thermostat control, hvac-control, home-automation, async-api-client

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