Pool Guardian has an official Home Assistant integration. It talks to your controller directly over your home network, so there is no cloud account to link, no MQTT broker to run, and nothing to log in to. It works on the Free plan.
Before you start: Home Assistant 2025.2 or newer, and your Pool Guardian on the same network as Home Assistant.
1
Add the repository to HACS. In Home Assistant, open HACS, click the three-dot menu in the top right, and choose Custom repositories. Paste https://github.com/PoolGuardian/pool-guardian-homeassistant into the repository field, set Type to Integration, and click Add.
2
Install and restart. Open the new Pool Guardian entry in HACS and click Download. Restart Home Assistant when it prompts you.
3
Add your controller. Go to Settings → Devices & Services. Your controller will be waiting there as a discovered Pool Guardian card — click Configure and you are done. If it does not appear, Home Assistant and the controller are probably on different network segments; click Add Integration, search for Pool Guardian, and enter the controller’s IP address or its .local name — the mobile app shows both under device settings.
4
Add the dashboard card (optional). The integration includes a Pool Guardian card that lays out water level, pump state, freeze protection and health in one place. Edit any dashboard, click Add card, search for Pool Guardian, and pick your controller from the list.
You get more than thirty entities out of the box: pump running, water detected at the high and low probes, water temperature from each probe, freeze protection state and all four thresholds, pump current, how long the last drain ran and why it stopped, plus WiFi signal, uptime and firmware diagnostics. Home Assistant polls the controller every 10 seconds by default, adjustable from 5 to 300 seconds.
One deliberate limitation: the integration is read-only. There is no switch or service to turn the pump on or off from Home Assistant. This controller can drain a pool, so pump control stays in the Pool Guardian app, where it is authenticated. Every entity still works as an automation trigger — you can have Home Assistant record a camera, send a notification, or turn on a light whenever a drain starts.
Renaming a controller later is always safe; the integration keys off the MAC address, not the name. Full documentation lives in the
integration repository.