---
title: "Tuya"
description: "Tuya is a built-in integration for Home Assistant. It has 166k installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/tuya"
url: "https://vulpo.app/integrations/core/tuya.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Tuya

> Tuya is a built-in integration for Home Assistant. It has 166k installs sharing analytics and needs the vendor's cloud.

Tuya is a built-in Home Assistant integration that connects Tuya cloud devices to Home Assistant. It relies on the vendor's cloud and is set up in the interface, using either a user code or a QR code. It covers many device types, including alarms, cameras, climate devices, covers, fans, humidifiers, lights, sirens, vacuums and valves. Sensors, binary sensors, switches, numbers and selects expose readings and settings such as battery state, air quality, child lock, alarm duration and charging mode. Buttons handle tasks like manual clean and resetting filters or brushes, and events report doorbell messages and pictures. Two actions get and set meal plan data on a Tuya feeder, and Home Assistant can discover the devices on the network.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=tuya)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

### Connect

- **User code**

Also asked when signing in again.

### Scan

- **QR code**

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Binary sensors**: Bag full, Carbon dioxide, Carbon monoxide, Coil freeze/defrost, Cover off, Defrost, Drop, Feeding, Filter cleaning, and 14 more
- **Buttons**: Factory reset, Manual clean, Reset duster cloth, Reset edge brush, Reset filter, Reset map, Reset roll brush, Snooze
- **Covers**: Blind, Curtain
- **Events**: Doorbell message, Doorbell picture
- **Lights**: Backlight, Light, Night light
- **Numbers**: Alarm delay, Alarm duration, Alarm maximum, Alarm minimum, Arm delay, Battery backup reserve, Charging current, Cloud recipe, Cooking temperature, and 29 more
- **Selects**: Anti-flicker, Night vision, Level, Brightness, Charging mode, Concentration, Countdown, Cups, Mode, and 26 more
- **Sensors**: Air pressure, Air quality, Air quality index, Battery, Battery power, Battery SOC, Battery state, Carbon dioxide, and 98 more
- **Sirens**: Siren
- **Switches**: Alarm push notifications, Anion, Arm beep, Auto clean, Auto-trigger siren, Battery lock, Child lock, Cry detection, and 48 more
- **Valves**: Valve

## Actions

- **Get feeder meal plan data**: Retrieves a meal plan from a Tuya feeder.
  Fields: Device
- **Set feeder meal plan data**: Sets a meal plan on a Tuya feeder.
  Fields: Device, Meal plan

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Built-in integration
- Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Smart home hubs
- Brand: [Tuya](https://vulpo.app/integrations/tuya.md)
- Number: 166k installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `tuya`
- Source: <https://www.home-assistant.io/integrations/tuya/>

In Vulpo: Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity (Pro), Vacuum Live Activity (Pro)

[Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities)

## Other ways in for Tuya

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [LocalTuya integration](https://vulpo.app/integrations/marketplace/rospogrigio-localtuya.md) | Marketplace integration | 33.4k installs sharing analytics | Works locally | No update in 6 to 18 months |
| [Tuya Local](https://vulpo.app/integrations/marketplace/make-all-tuya-local.md) | Marketplace integration | 20.4k installs sharing analytics | Works locally | Updated in the last 6 months |
| [Xtend Tuya](https://vulpo.app/integrations/marketplace/azerty9971-xtend-tuya.md) | Marketplace integration | 3.4k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [Tuya Smart IR AC](https://vulpo.app/integrations/marketplace/enzod86-tuya-smart-ir-ac.md) | Marketplace integration | 1k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [LocalTuyaIR Remote Control](https://vulpo.app/integrations/marketplace/clusterm-localtuya-rc.md) | Marketplace integration | 467 installs sharing analytics | Works locally | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/tuya

---

- HTML version of this page: https://vulpo.app/integrations/core/tuya
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
