The Tuya2Matter add-on bridges your Tuya devices into Matter, so they can be discovered and controlled by Home Assistant, Apple Home, Google Home, or any other Matter controller.
-
In Home Assistant, go to Settings → Add-ons → Add-on Store.
-
Click the ⋮ (menu) button in the top-right corner and choose Repositories.
-
Add this repository URL:
https://github.com/duongvanba/tuya2matter -
After adding the repository, the Tuya2Matter add-on will appear in the store.
-
Click Install to install the add-on.
-
Get your User Code from the Smart Life / Tuya Smart app:
-
On the tab bar, select "Me".
-
Tap the gear icon (⚙️) in the top-right corner.
-
Select "Account and Security".
-
At the bottom, your User Code will be shown.
-
-
Open the Tuya2Matter add-on in Home Assistant.
-
Go to the Configuration tab.
-
Enter your User Code into the field
user_code. -
Click Save.
Note: The add-on will only start for the first time after you click Save.
-
After you Save and the add-on starts, open the Log tab.
-
The add-on will display a Matter QR code.
-
Open your Matter-compatible app (Home Assistant, Apple Home, Google Home, etc.).
-
Add a new Matter device and scan the QR code from the log.
-
Follow the on-screen steps until the pairing process asks for Tuya confirmation.
-
After Matter pairing is complete, the add-on will print another QR code in the log -- this is the Tuya confirmation code.
-
Open the Smart Life / Tuya Smart app.
-
Use the built-in scanner and scan the Tuya QR code from the log.
-
Confirm the binding in the app.
Your Tuya account and devices are now linked to your Matter fabric.
The devices should appear in your smart home system and can be used in automation immediately. 🎉