OwlConnect OwlWatt to Home Assistant
Bring real-time solar production, energy dashboard data, and guarantee-tracking right into your Home Assistant setup — in minutes, via HACS.
The OwlWatt Home Assistant integration bridges your solar monitoring data into the HA ecosystem. Once connected, your solar production figures, expected output, and guarantee status appear as native HA entities — ready to use in the Energy dashboard, Lovelace cards, automations, and scripts. No cloud polling lag, no custom templating, no pasting CSV files.
OwlWatt itself reads from your Enphase IQ Gateway, runs physics-based expected-production modeling against real weather data, and computes whether your system is meeting its installer-promised production guarantee. The HA integration surfaces all of that in your existing Home Assistant instance — by Olivier Beauchemin.
Get started in three steps
You need an OwlWatt account, the OwlWatt integration installed via HACS, and your API token entered into Home Assistant. About five minutes end to end.
Create your OwlWatt account
Sign up at owlwatt.com and connect your Enphase system. After signup, copy your API token from Settings → API tokens — you'll paste it into Home Assistant in step 3.
Add OwlWatt to HACS
OwlWatt is currently installed via HACS as a custom repository while we wait on default-catalog inclusion. In Home Assistant: HACS → ⋮ menu (top right) → Custom repositories. Paste https://github.com/owlwatt/owlwatt-home-assistant, category Integration, then click Add. OwlWatt will then appear in your HACS integrations list — click Download and restart Home Assistant.
(Don't have HACS yet? Install it first from hacs.xyz — it's a one-time setup that unlocks community integrations.)
Connect with your API token
After HA restarts, go to Settings → Devices & Services → Add Integration, search for OwlWatt, and paste the API token you copied in step 1. Your solar sensors — production, expected production, shortfall, anomalies — appear under the new OwlWatt device within seconds and flow into the Home Assistant Energy dashboard.
Entities exposed in Home Assistant
After setup, a single OwlWatt device appears under Settings → Devices & Services. It exposes the following sensors:
| Entity | Description |
|---|---|
| production_kwh | Actual energy produced today, in kWh. Feeds directly into the HA Energy dashboard solar production card. |
| expected_kwh | Physics-based expected production for today, derived from NREL irradiance data and your system specifications. |
| shortfall_kwh | Today's production gap vs. expected. Positive means underperformance; use this in automations to notify when shortfall exceeds a threshold. |
| panels_reporting | Number of panels (microinverters) actively reporting data. Drops when a microinverter goes offline — useful for alerts. |
| guarantee_status | Current production guarantee tracking status: on_track, at_risk, or below_guarantee. Updates daily. |
All sensors are compatible with the HA Energy dashboard and the standard sensor platform. production_kwh and expected_kwh use the energy device class for direct Energy dashboard integration.
Frequently asked questions
Common questions about the OwlWatt Home Assistant integration.
Does this require a paid OwlWatt plan?
Yes — the integration authenticates via your OwlWatt API token, which is available on any paid plan or during the 30-day free trial. You can test the full integration during the trial period without entering a credit card. After the trial, a subscription ($9.99/month or $87.89/year) keeps the sensors updating.
Will it slow down my Home Assistant instance?
No. The integration uses a standard polling coordinator that fetches from the OwlWatt API at a configurable interval (default: 5 minutes). The API call is lightweight — a single JSON payload under 2 KB — and uses async I/O so it does not block the HA event loop. It has no local database writes and no background threads.
Can I use the sensors in an automation?
Yes. All OwlWatt sensors are standard HA entities and work in automations, scripts, and templates exactly like any other sensor. A common use case: trigger a notification when shortfall_kwh exceeds 2.0 for two consecutive days, or alert when panels_reporting drops below your system's panel count. The guarantee_status sensor is useful for a monthly dashboard card that shows guarantee tracking at a glance.
Does it work with HA Cloud / Nabu Casa?
Yes. The integration makes outbound HTTPS calls to the OwlWatt API — it does not require any inbound connectivity to your HA instance. HA Cloud, a VPN, or a fully local HA install all work the same way. There is no webhook or reverse tunnel required on the OwlWatt side.
Ready to connect your solar system?
Start your free 30-day trial — no credit card, cancel anytime.
Start your 30-day free trial