Trying to add SwitchBot Mini Hub using Matter

Configuration Matter/Thread
1

I’m tryiing to add the Matter-enabled SwitchBot Mini Hub to my Home Assistant system and failed so far.

The Mini Hub is all setup and has devices registered. In the Switch Bot app I can start the Matter setup which produces a Matter setup code like xxxx-xxx-xxxx and a QR code.

In the Home Assistant Matter add-on I try to add a new device. The add-on asks for a Matter setup code which I suppose is the same xxxx-xxx-xxxx code I see in the SwitchBot app. So I enter this setup code and wait.

But nothing happens… after a while the Home Assistant Matter add-on just asks for a Matter setup code again.

What am I doing wrong? Any help or hint is appreciated.

2

Is it a Matter over WiFi or Matter over Thread device?
If it is a Thread device you need to install an OTBR

3

To clarify, there are a number of ways to add a Matter device and it seems like you’re using the Matter add-on web dashboard interface? The one that says “Matter Python Server” and has a " + Commission Node" button? This method only works if the add-on has its own bluetooth dongle and is within (bluetooth) range of the device being commissioned. It’s far more common to use a phone running the HA companion app, which has a camera to scan the barcode on the side of the device, but even that has several caveats and may depend whether you’re an iPhone or Android user, so additional information would be helpful — what steps, specifically, have you tried so far?

4

I had a similar problem and just solved it.
Coupling the hub just in the pairing mode with Home Assistant did not work out. But the following steps did.

  1. Using Home Assistant OS 2025.12.5
  2. Installed Add-On Matter Server 8.1.2
  3. Installed Android Companion-App 2025.11.4-full on my Pixel 6 with Android 16
  4. Reset the Switchbot Hub Mini (9E) by pressing the button for 15sec until the light goes out and then starts blinking slowly again
  5. Press button again for 3sec until the light blinks fast.
  6. Scan the Matter QR code with your phones QR Scanner App. This started on my phone a Matter Setup (not yet assigned to Home Assistant)
  7. Follow the setup, which in my case found the device, brought it to my Wifi and asked where to add the device to.
  8. Choose Home Assistant as Smart Home App, which opened the Home Assistant App
  9. Confirm to add the device in Home Assistant (this failed once in my case, for an unknown reason, I repeated the whole process again and it worked)
  10. Add the Hub again in the Switchbot App.
  11. Add secondary devices, I my case a S10 vacuum
  12. Find the device in Home Assistant without additional actions.