homebridge-controlmyspa

Homebridge plugin to integrate Balboa ControlMySpa hot tubs into HomeKit

Plugin Information

• This plugin allows you to control your ControlMySpa hot tub within HomeKit. The plugin:
  • requires your ControlMySpa account credentials to work
  • connects to the ControlMySpa cloud, the same way the official mobile app does
  • exposes for each spa:
    • a thermostat for the water temperature and heater mode (READY/REST)
    • a switch for each jet pump and blower
    • a light for each spa light
    • an optional lock for the spa's physical control panel
• This plugin is for spas connected to the ControlMySpa cloud. If your Balboa spa uses a local WiFi module instead, homebridge-balboa-spa may suit better.

Prerequisites

• To use this plugin, you will need to already have:
  • Node: latest version of v22, v24 or v26 - any other major version is not supported.
  • Homebridge: v2 - refer to link for more information and installation instructions.

Setup

• Installation
• Configuration
• Beta Version
• Node Version

Help/About

• Common Errors
• Support Request
• Changelog
• About Me

Credits

• The current ControlMySpa cloud protocol is documented by @haresik's Home Assistant integration, which this plugin's api client is based on.
• The original ControlMySpa cloud protocol was first documented by @VVlasy's controlmyspajs.

Disclaimer

• I am in no way affiliated with Balboa Water Group and this plugin is a personal project that I maintain in my free time.
• Use this plugin entirely at your own risk - please check your spa manually before use if temperature matters to you.