Matterbridge iRobot plugin

May 11, 2026 ยท View on GitHub

npm version npm downloads Docker Version Docker Pulls Node.js CI CodeQL codecov styled with prettier linted with eslint TypeScript ESM matterbridge.io

powered by powered by powered by


iRobot logo

This plugin allows you to expose iRobot devices to Matter.

Features:

  • device retrieval from the iRobot cloud
  • automatic discovery of iRobot devices on the local network

The plugin requires matterbridge v.3.7.3.

Tested devices

ModelSupported commandsSupported phasesTested by
j715840start stop pause resume goHomecharge run stop hmUsrDockLuligu

Please let me know which iRobot devices have also been tested.

How to get your username/blid and password using the plugin config

Put your iRobot account credentials (username and password) in the config editor and click Retrieve.

If it doesn't work, use any of the methods in dorita980.

Given the financial issues iRobot is facing, save your credentials somewhere safe. If the iRobot platform shuts down, you will not be able to retrieve them anymore.

Apple Home issues with RVC

As of version 18.4.x, the Home app supports Robot Vacuum Cleaners only as single, non-bridged devices or when the robot is the only device in the bridge. Furthermore, the device cannot be a composed device. The only supported device type is the RVC.

If a robot is present alongside other devices in the bridge, the entire bridge becomes unstable in the Home app.

If you pair with Apple Home, always set Enable Server RVC in the config. With "Enable Server RVC," you will have a separate QR code for pairing each iRobot device you have.

Credits

This plugin credits dorita980 for the prior work around iRobot account credential retrieval and local robot integration.

The dorita980 project has been a useful reference for understanding the iRobot login flow and for helping users retrieve their BLID and password.