Tuya

Tuya Matter

homebridge-tuya-matter · v1.0.9

VerifiedConnection not statedMatterHomebridge 2.0

Bridges Tuya devices to Apple Home over Matter through Homebridge 2.

View on npm Source code

What it says it supports

Brands

Tuya

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Covers many Tuya categories; the maintainer tested ~170 devices. Heat pumps and underfloor heating are not yet supported.

Works3
Partly works1
Requested2

The plugin’s own supported-device list

Device	Status	What they said	Source
Tuya heater (category qn)	Works	Matter thermostat type, temp conversion fixed; tested with ~170 Tuya devices Saved copy Context Tested with ~170 Tuya devices on Homebridge 2.0 + matter.js 1.5.1. The `qn` heater category was completely broken in Matter mode, and motion/presence sensors were silently ignored by the platform. Bugs fixed 1. `tuyashopenapi.mjs`, getDevicesFunctions crashes on SH API error 1106 Smart Home PaaS (projectType=2) returns error 1106 for the `/v1.0/devices/functions` endpoint. Was throwing and aborting the entire device load. Now logs a warning and returns `[]`. 2–5. `matter/heater_accessory.mjs`, Heaters exposed as OnOffSwitch Offline devices silently ignored: `hasCode()` returns false … Excerpt saved from GitHub on 2026-10-22.	PR #5 · 2026-05
Tuya lights, switches, plugs, fans, AC (device reference)	Works	Categories dj, tgq, kg, cz, kt, qn, fs and more implemented Saved copy Tuya Device Implementations Reference document for porting device support to another Tuya smart home integration. Each entry lists the Tuya category codes, the smart home service type it maps to, the DP codes it reads/writes, and any notable implementation details. --- Shared Characteristic Helpers Before implementing individual devices, these reusable helpers are worth extracting: \| Helper \| Purpose \| \|---\|---\| \| Light \| Covers all 6 light types: on/off, brightness-only (C), brightness+color-temp (CW), RGB, RGB+brightness (RGBC), RGB+brightness+color-temp (RGBCW). Handles `work_mode` … Excerpt saved from GitHub on 2026-10-22.	Docs: devices.md
Tuya motion/presence sensors (hps/pir)	Works	Previously ignored in Matter mode; fixed in merged PR Saved copy Context Tested with ~170 Tuya devices on Homebridge 2.0 + matter.js 1.5.1. The `qn` heater category was completely broken in Matter mode, and motion/presence sensors were silently ignored by the platform. Bugs fixed 1. `tuyashopenapi.mjs`, getDevicesFunctions crashes on SH API error 1106 Smart Home PaaS (projectType=2) returns error 1106 for the `/v1.0/devices/functions` endpoint. Was throwing and aborting the entire device load. Now logs a warning and returns `[]`. 2–5. `matter/heater_accessory.mjs`, Heaters exposed as OnOffSwitch Offline devices silently ignored: `hasCode()` returns false … Excerpt saved from GitHub on 2026-10-22.	PR #5 · 2026-05
Tuya Matter-registered accessories (mixed)	Partly works	User got only 2 devices working in Matter; rest failed to register Saved copy ## Failed to register Matter accessory (Matter) Got 2 devices working with matter, The rest does not work. I will share the logs to help u out, so that u can help me out. ### Logs [5/7/2026, 8:28:23 PM] [Matter/Server] ============================================================ [5/7/2026, 8:28:23 PM] [Matter/Node] [REDACTED_ID] going online [5/7/2026, 8:28:23 PM] [Matter/Node] [REDACTED_ID] is online [5/7/2026, 8:28:23 PM] [Matter/Accessories] Loaded 2 cached Matter accessories [5/7/2026, 8:28:23 PM] [Matter/Server] Matter server started successfully on port 5530 [5/7/2026, 8:28:23 PM] … Excerpt saved from GitHub on 2026-10-22.	Issue #3 · 2026-05
Tuya smart heat pump (category znrb)	Requested	Accessory not created; apparently unsupported category, issue open Saved copy Hi, I haven't yet been able to find a Tuya plugin which will connect/ run a Smart Heat Pump which I have connected on Tuya. When I run the plugin (v1.0.9) it returns the following: [20/07/2026, 20:37:40] [TuyaPlatformMatter] Initializing accessory: Heat Pump (znrb / bffc0ad056c71e7d95jxnf) without creating the new accessory (as it does with other Tuya accessories). I'm assuming that Smart Heat Pumps not supported at this time? As noted above, no plugins (as I can find) currently do, so if I can assist in anyway to get it going would be happy to assist. Excerpt saved from GitHub on 2026-10-22.	Issue #8 · 2026-07
Tuya underfloor heating (category wk)	Requested	Plugin fails to create accessory in v1.1.0-beta3; issue open Saved copy Hi There, I have installed your plugin v1.1.0-beta3 and it pulls through all my Tuya devices and attempts initialise an underfloor heating device. But fails to create the accessory. It should work as works with home assistant tuua and the homebridge tuya plug-in. Any ideas Initializing accessory: Underfloor Heating (wk / 12428526bcff4d0a0a59) Excerpt saved from GitHub on 2026-10-22.	Issue #7 · 2026-07

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Connection not stated

Compatibility

Verified by Homebridge	Yes
Homebridge versions	^1.3.0 \|\| ^2.0.0
Homebridge 2.0	Yes
Node.js	^20.15.1 \|\| ^22 \|\| ^24
Settings in Homebridge UI	Yes
Matter	Yes (uses the Homebridge 2 Matter API)
Platform name	TuyaPlatformMatter
License	MIT

Community signals

Downloads a week	10
Downloads a month	96
GitHub stars	3
Open issues	3
Closed issues	4
Last code push	2026-07-10
Latest version	1.0.9 (2026-07-10)
First published	2026-03-30
Releases	18

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.