Need help with homebridge-tuya-lan?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

130 Stars 31 Forks MIT License 103 Commits 138 Opened issues


Homebridge plugin for IoT devices that use Tuya Smart's platform

Services available


Need anything else?

Contributors list

# 351,103
103 commits


Homebridge plugin for IoT devices that use Tuya Smart's platform, allowing them to be exposed to Apple's HomeKit.


Install this plugin using

npm i -g homebridge-tuya-lan

Update the

file of your Homebridge setup, by modifying the sample configuration below. Detailed steps for getting the
combinations of your devices can be found on the Setup Instructions page.


Update to the latest release of this plugin using

npm i -g homebridge-tuya-lan

If you feel brave, want to help test unreleased devices, or are asked to update to the latest unreleased version of the plugin, use

npm i -g AMoo-Miki/homebridge-tuya-lan


The configuration parameters to enable your devices would need to be added to

section of the Homebridge configuration file. Examples of device configs can be found on the Supported Devices page. Check out the Common Problems page for solutions or raise an issue if you face problems.
    "platforms": [
        /* The block you need to enable this plugin */
            "platform": "TuyaLan",
            "devices": [
                /* The block you need for each device */
                    "name": "Hallway Light",
                    "type": "SimpleLight",
                    "manufacturer": "Cotify",
                    "model": "Smart Wifi Bulb Socket E26",
                    "id": "011233455677899abbcd",
                    "key": "0123456789abcdef"
                /* End of the device definition block */ 
        /* End of the block needed to enable this plugin */


  • name
    (required) is anything you'd like to use to identify this device. You can always change the name from within the Home app.
  • type
    (required) is a case-insensitive identifier that lets the plugin know how to handle your device. Find your device
    on the Supported Devices page.
  • manufacturer
    are anything you like; the purpose of them is to help you identify the device.
  • id
    (required) and
    (required) are parameters for your device. If you don't have them, follow the steps found on the Setup Instructions page.
  • ip
    needs to be added only if you face discovery issues. See Common Problems for more details.

To find out which

belongs to which device, open the Tuya Smart app and check the
Device Information
by tapping the configuration icon of your devices; it is almost always a tiny icon on the top-right.


To create this plugin, I learnt a lot from Max Isom's work on his TuyAPI project to create my communication driver.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.