Integrations
Crystal Water Monitor for Home Assistant
The Crystal Water Monitor Home Assistant integration connects your Crystal Water Monitor to Home Assistant, giving you water quality data, water history graphs and more in your smart home dashboard.
Features
- See water status at a glance - know immediately if your water is balanced, needs attention, or is unsafe
- Track chemistry trends - add cards to view pH, ORP, and temperature history
- Automate around water quality - trigger automations based on any reading or status change
- Monitor your equipment - track battery voltage, WiFi signal strength, and sensor health
- Sensors - pH, ORP, and Temp. from your Monitor, TA, TH, CYA and more from your water reports.
Custom Dashboard Cards
The Crystal Water Monitor Home Assistant integration provides several custom cards that you can add to your dashboards.
Crystal Disc Card
A color-coded disc that looks just like your disc in the Crystal App and shows your overall water status instantly — blue for balanced, orange for needs attention, and red for needs immediate attention.
You can also add water reading badges alongside the disc (left, right, or below), and badge colors automatically reflect each reading's status.
Crystal Actions Card
See exactly what your pool needs. The Actions card lists the actions visible in the app with titles and step-by-step details. When everything is balanced, it shows a clean "no actions needed" state.
Crystal Graph Cards: pH, ORP, Water Temperature
Graphs of your pH, ORP, and temperature readings over your chosen window (6, 12, 24, 48, or 72 hours). Note that you can also add standard Home Assistant graphs for your other readings like TA, TH, and CYA,
Installation Requirements
- Home Assistant 2026.6.0 or later
- A Crystal Water Monitor device with an active monitoring subscription connected to your WiFi
- A valid Crystal Connect API key (Request an API Key)
Installation
Currently, we are distributing the Crystal Water Monitor Home Assistant integration via Home Assistant Community Store (HACS). If you don't already have HACS installed on your Home Assitant, follow this link to install HACS. We'll be pursuing official distribution in Home Assistant but it will take some time.
Once you've installed HACS, add a custom repository with the following url: https://github.com/general-galactic/home-assistant-crystal-water-monitor. You can also use this link:
We're currently working on publishing to HACS to prevent the need for this this step.
Once, the repository is configured in HACS you can download the integration.
After you've downloaded the integration, restart your Home Assistant to make it active. Then you can click and configure the Crystal Water Monitor integration from you Addons UI in Home Assistant.
You'll be asked to enter your Connect API Key when initially configuring the integration.
API Keys
You'll need a request Crystal Connect API key.