Skip to content

Add Green Planet Energy integration documentation #40279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: next
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 75 additions & 0 deletions source/_integrations/green_planet_energy.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
title: Green Planet Energy
description: Instructions on how to integrate Green Planet Energy dynamic electricity pricing into Home Assistant.
ha_category:
- Energy
- Sensor
ha_release: 2025.9
ha_iot_class: Cloud Polling
ha_config_flow: true
ha_codeowners:
- '@petschni'
ha_domain: green_planet_energy
ha_platforms:
- sensor
ha_integration_type: service
---

The **Green Planet Energy** {% term integration %} provides real-time electricity pricing data from Green Planet Energy, a German renewable energy provider. It fetches hourly electricity prices and provides various sensors for energy optimization and monitoring. It visualizes the prices so that you can adapt your power consumption and shift it to cheaper hours.

## Prerequisites

You don't need to have an account with Green Planet Energy for this integration to work. However, the integration will probably only make sense if you are their customer with a dynamic energy tariff. For the setup, no additional information is required.

{% include integrations/config_flow.md %}

## Sensors

The **Green Planet Energy** integration provides the following sensors.

### Current price

- **Current price**: The current electricity price in EUR/kWh

### Hourly prices

- **Price XX:00**: Hourly electricity prices for each hour of the day (00:00 to 23:00)

### Statistics

- **Highest price today**: The highest electricity price for the current day
- **Lowest price day**: The lowest electricity price during day hours (6:00-18:00)
- **Lowest price night**: The lowest electricity price during night hours (18:00-6:00)
- **Price chart 24h**: 24-hour price chart data

## Examples

### Apex chart

You can visualize the electricity prices using the ApexCharts card:

````yaml
type: custom:apexcharts-card
header:
title: Electricity prices - 24 hours
show: true
graph_span: 24h
span:
start: day
now:
show: true
label: Now
series:
- entity: sensor.gpe_price_chart_24h
type: column
attribute: chart_data
data_generator: |
return entity.attributes.chart_data.map((entry) => {
return [new Date(entry.datetime).getTime(), entry.price];
});

## Removing the integration

This integration follows standard integration removal.

{% include integrations/remove_device_service.md %}