---
id: growattserver
version: "2.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# growattServer — A package to talk to growatt server

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

## What it is and what it does

Growatt Server is a Python client library for querying Growatt photovoltaic inverter systems. It abstracts the Growatt API into a usable interface, supporting both the legacy password-based authentication method and the newer official V1 token-based API. The library depends only on requests for HTTP communication.

The package is designed for reading PV system data—status, performance metrics, and configuration—from Growatt servers. It also exposes configuration modification functions, though the maintainers emphasize that only settings functions alter system state; all other operations are read-only. The library is actively maintained and includes examples for both API variants, with V1 API recommended for new projects due to better security and relaxed rate limits.

Use it for:

- Monitor solar inverter performance and energy production in real-time dashboards or home automation systems.
- Retrieve historical PV data for analysis, reporting, or integration with energy management platforms.
- Automate configuration changes to Growatt inverters programmatically (with caution, as settings can affect system operation).
- Build custom alerting systems that check inverter status and notify on faults or performance anomalies.
- Integrate Growatt data into smart home ecosystems or IoT platforms that aggregate multiple energy sources.

## Worth the install?

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

Retrieves photovoltaic system information from Growatt inverter servers using either the legacy password-based API or the official token-based V1 API.

Yes, if you own or manage Growatt inverters and need programmatic access to their data. The package is actively maintained, has low install friction, uses a permissive license, and carries no known vulnerabilities. The main caveat is that configuration modification functions carry real operational risk—use only if you understand the consequences—and V1 API support is currently limited to MIN and SPH device types.

## Install

pip install growattserver
uv add growattserver
poetry add growattserver

## Installing growattServer

Before you install: Low install friction with a single runtime dependency (requests). Active maintenance with a recent release (68 days ago) and ongoing repository activity.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install growattServer

from growattServer.api import GrowattApi
api = GrowattApi()
# Login and retrieve data using either legacy or V1 API

Requires valid Growatt account credentials and network access to Growatt servers; V1 API supports MIN and SPH devices specifically.

Verify before relying:

- Whether the package works with all Growatt inverter models or only those explicitly listed (MIN, SPH, classic TLX, classic MIX).
- Specific Python version compatibility (requires_python is unspecified in metadata).
- Rate limiting behavior and recommended polling intervals for production use.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 90.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

growatt inverter api client, solar pv monitoring growatt, growatt server data retrieval, growatt inverter status, growatt plant monitoring, solar system api integration, growatt device configuration, solar-energy, inverter-monitoring, api-client

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