🌱 Plant Monitor for Home Assistant
A comprehensive plant monitoring integration for Home Assistant that treats each plant as a device with its own sensors, thresholds, and health tracking. Automatically fetches species data from OpenPlantbook to configure optimal growing conditions.
[!WARNING]
This integration is not compatible with the original built-in plant integration in Home Assistant.
📑 Table of Contents
🌿 Overview
Each plant is a device in Home Assistant, grouping all its related entities together:
Key features:
- 🖥️ UI-based setup — guided multi-step config flow with optional OpenPlantbook search
- 📊 Per-plant thresholds — each threshold is its own entity, adjustable from the UI or via automations
- 🌤️ Daily Light Integral — automatic DLI calculation from illuminance sensors
- 💧 Vapour Pressure Deficit — automatic VPD calculation from temperature + humidity
- 🔄 Live updates — change sensors, thresholds, species, or images without restarting HA
- 🚨 Problem detection — configurable per-sensor problem triggers
- 🔌 Auto-disable — sensors without a source entity are automatically disabled
📦 Installation
1. Install OpenPlantbook (optional but recommended)
The OpenPlantbook integration automatically fetches species data, thresholds, and images. Without it, you must set all thresholds manually.
- Install from HACS or manually
- Register at open.plantbook.io (free)
- Add your
client_id and secret in the integration config
- Test with the
openplantbook.search action
2. Install Plant Monitor
Via the Marketplace (HACS before Home Assistant 2026.11)
- Select the button above, or add this repo as a custom repository with type Integration
- Click Install in the "Home Assistant Plant" repository. From Home Assistant 2026.11, the Marketplace asks you to confirm that it replaces the built-in
plant integration
- Restart Home Assistant
Manual Installation
- Copy
custom_components/plant/ to your <config>/custom_components/ directory
- Restart Home Assistant
After restart, add plants via Settings → Devices & Services → Add Integration → Plant Monitor.
The Flower Card comes with Plant Monitor. If you installed it separately before, Home Assistant shows a repair asking you to remove that copy.
🔧 Setup & Configuration
The config flow guides you through plant setup in four steps:
Step 1: Name & Species
Enter a name for your plant. Optionally enter a species to search OpenPlantbook.
- If OpenPlantbook is installed and a species is entered, the flow proceeds to species selection
- If no species is entered (or OpenPlantbook is not installed), the flow skips to sensor selection
Step 2: Select Species (OpenPlantbook only)
If OpenPlantbook found matches, select the correct species from a dropdown list. You can also re-search with a different term if the initial results aren't right.
If the wrong species was selected, you can go back and search again.
Step 3: Select Sensors
Choose which physical sensors to associate with your plant. All sensors are optional and can be added or changed later. Available sensor types:
| Sensor | Device Class | Description |
|---|
| 🌡️ Temperature | temperature | Air temperature |
| 💧 Soil moisture | moisture | Soil water content |
| ⚡ Conductivity | conductivity | Soil nutrient level |
| ☀️ Illuminance | illuminance | Light level |
| 💨 Air humidity | humidity | Air moisture |
| 🫧 CO2 | carbon_dioxide | CO2 concentration |
| 🌡️ Soil temperature | temperature | Soil temperature |
Fill sensors from device — if one device reports several of these measurements (a soil probe, a multi-sensor), pick it in the top field. The form reloads with every matching empty field filled in, and you can still change any of them by hand. Fields you already filled in yourself are left alone.
Matching is by device class, so the device must report the correct one. A device class with more than one candidate entity is left blank rather than guessed. Temperature is the exception: a temperature entity whose name or id mentions "soil" goes to soil temperature, and a single remaining one goes to (air) temperature.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
