Setting up iRobot Roomba Max 700 is pretty simple with Matter

Configuration
1

Hi everybody,

I have a Combo 705 Roomba, it didn’t work with the built-in iRobot integration, and it didn’t work with Rest980 either. Reading the docs for dorita980/rest980 I discovered that from Firmware version 4 Roombas are now “Matter-first” and don’t work with dorita. Despair! But… do not despair! It’s actually pretty simple to get it connected through Matter if you have the HA companion app!

Here’s what I did:

  1. Open the “Roomba Home” iPhone app, press the account icon “top left” and select “Connected Services”
  2. Select the “Matter” option and hold the phone close to the vacuum
  3. The vacuum beeps, I pressed something and it beeped again. After a while I got a QR code and an activation code, which I copied to the clipboard.
  4. Open the Home Assistant companion app on the iPhone, select “Add Integration” and then “Add Matter Device”
  5. The companion app turns on the camera and asks you to scan the QR code, but it also allows you to paste in the activation code as well if you click on the “other options” text. So, paste in the activation code you copied earlier.
  6. Done! The Vacuum appears on the main HA UI, I can automate it, see the battery level, and so on.

Hope this helps people with newer botvacs!

2

Thank you so much for this. I had previously tried and failed to get this roomba working with HA. The Matter pairing trick had it connected in 2 mins.

3

The “It currently does NOT work with the newer x05 Wi-Fi models” note is the key thing here, and it’s worth explaining why, because it’s not a bug that’ll get fixed in the existing integration — the 105/405/505 (and other newer models) are a different generation entirely. iRobot calls it “Prime”; people here have been calling it “V4”. It doesn’t speak local MQTT with a blid/password at all — it’s cloud-only, different auth, different everything under the hood. The existing Roomba integration (and roombapy, which it’s built on) fundamentally can’t be extended to cover it — it would need to be a separate client.

So I’ve been building one: roombapy-prime — a from-scratch async Python client for exactly this generation, reverse-engineered from the Prime app (decompilation + the app’s own bundled config files, not guesswork). I posted about it here: Looking for iRobot Prime/V4-generation owners to test a new Python library

Between the two of you (@BalkonYossi, @deanpm70) there’s a decent little cluster of 700 owners in this one thread — exactly the hardware I have no way to test against myself. If any of you are willing to run a read-only diagnostic script against your account (logs in, reads state/favorites/history — never sends a command or changes anything), that’s genuinely the bottleneck right now:

pip install git+https://github.com/johnnyh1975/roombapy-prime.git
roombapy-prime-validate --username [email protected] --country-code US

I also maintain ha_roomba_plus (unrelated name collision with your “Roomba Plus” model, sorry for the confusion that’s probably about to cause) — a HACS integration currently covering Classic-protocol robots. The plan, once roombapy-prime is confirmed working, is to fold Prime/V4 support into that same integration so this generation isn’t left out permanently. Right now that’s blocked entirely on real accounts confirming the library actually works — which is where this thread’s owners would help a lot.

4

I wish this would work with the 400 Plus Combo. Not sure if they just didnt include the hardware to connect to matter or if its more of a software setting that needs to be enabled or added..

5

@homejohn Good news/bad news on this: iRobot actually did just roll out Matter support via firmware update (this past December/January) — but only for the 500 and 700 series (Roomba Plus 504/505, Roomba Max 705 Vac/Combo), plus the Combo 10 Max that already had it. The 400 series isn’t on that list, so no Matter for the 400 Plus Combo specifically, at least not yet. Might change in a future update given they’ve been actively expanding the list, but nothing confirmed for the 400 line as of now.

Even where Matter is available, it’s fairly limited — basic start/stop, vacuum vs. mop, and picking a room work, but no map creation/editing and no camera access without falling back to the iRobot app.

For the 400 series specifically, there’s an active project building fuller Home Assistant support instead — ha_roomba_plus and its underlying library roombapy-prime. Talks to iRobot’s cloud API directly. Still alpha: start/stop/pause/dock/locate, a live cleaning map, and battery/status sensors all work and are confirmed on real 400-series devices, but room/zone selection is still being built and tested.

If you want to try it, grab the latest alpha release and update through HACS. More real-device testing is always welcome if you’re up for it.