Navien Smart for Home Assistant

A Home Assistant custom integration for controlling Navien Smart heating mats.

English | 한국어

Features

• Provides climate entities for heating mats
• Supports dual-zone left/right split mode for supported devices (separate_control)
• Real-time status updates via AWS IoT MQTT
• sound_enabled: use operation beep on supported devices
• scan_interval: coordinator polling interval (seconds)
• MQTT state synchronization
  • Uses AWS IoT MQTT (WebSocket) real-time updates by default
  • Automatically falls back to REST polling if MQTT connection fails
  • In fallback mode, scan_interval directly affects status update latency
  • Even when MQTT is healthy, scan_interval is used as a watchdog for session refresh/recovery

Installation

1. Install the Navien app on your smartphone, sign up, and complete device pairing at least once.
2. Install HACS in Home Assistant.
3. Open HACS in Home Assistant.
4. Go to Integrations -> top-right menu -> Custom repositories.
5. Add this repository URL and select Integration as the category.
6. Search for Navien Smart and install it.
7. Restart Home Assistant.
8. Go to Settings -> Devices & Services -> Add Integration -> select Navien Smart.

Shortcut:

Notes

• This integration uses an unofficial API (based on reverse engineering).
• This plugin has only been tested with EME520 and EMW720 models.
• Supported models are limited, and behavior may vary by device/firmware.
• The previous Homebridge implementation was removed from this repository; it is now Python/HA-only.

Post-install Setup

Settings -> Devices & Services -> Integrations -> Add Integration -> search for Navien Smart

Or:

Auth modes (choose one)

• account (recommended for first setup)
  • Inputs: username, password
• token
  • Inputs: username, refresh_token, account_seq
  • Use this if you do not want to store your password in Home Assistant

Development

Integration source path:

• custom_components/navien_smart

Validation workflows:

• .github/workflows/validate.yml
• .github/workflows/hassfest.yml