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 your 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.

Crystal Disc Card Example

You can also add water reading badges alongside the disc (left, right, or below), and badge colors automatically reflect each reading's status.

Crystal Disc Card Config Example

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 Actions Card Example

Crystal Actions Card Config Example

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,

Crystal Graph Card Example

Crystal Graph Card Config Example

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

The Crystal Water Monitor integration is available in the Home Assistant Community Store (HACS). If you don't already have HACS installed, follow the HACS installation guide first. We're also pursuing official distribution in Home Assistant, but that will take some time.

  1. In Home Assistant, open HACS and search for Crystal Water Monitor, or use this button to go straight to it:
    Open your Home Assistant instance and open the Crystal Water Monitor integration in HACS.
  2. Click Download.
  3. Restart Home Assistant.
  4. Go to Settings → Devices & Services → Add Integration and select Crystal Water Monitor.
  5. Enter your Crystal Connect API key when prompted (see below).

API Keys

You'll need to request Crystal Connect API key.

Resources

Report an issue