---
title: "Tuya Heat Pump"
description: "Tuya Heat Pump is a Marketplace integration for Home Assistant. It has 117 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026."
canonical: "https://vulpo.app/integrations/marketplace/korkuttum-tuya-heat-pump"
url: "https://vulpo.app/integrations/marketplace/korkuttum-tuya-heat-pump.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Tuya Heat Pump

> Tuya Heat Pump is a Marketplace integration for Home Assistant. It has 117 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026.

Tuya Heat Pump controls and monitors a Tuya heat pump device from Home Assistant. It connects through the Tuya cloud, and a local network mode with a device IP address and local key is also offered. Optional MQTT push can be added on top of cloud mode, using a user code and a QR scan, to get state updates without waiting for the refresh interval. It provides binary sensors, climate, numbers, selects, sensors, switches and texts, plus a work mode select. An optional thermostat card can be built from the power switch, temperature entities and mode select, with minimum and maximum target temperatures and compressor protection timing. If the MQTT sign-in becomes invalid, a notice appears in Repairs, and setup is done in the UI.

Automatic summary of the README and code of Korkuttum/tuya\_heat\_pump. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Korkuttum&repository=tuya_heat_pump&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Korkuttum&repository=tuya_heat_pump&category=integration)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Tuya Heat Pump Setup

- **Access ID**
- **Access Key**
- **Device ID**
- **Region**
- **Connection Type**
- **User Code (optional — for MQTT)**: Found in the Tuya app under Me → Settings → Account and Security → User Code. If provided, you'll be asked to scan a QR code after this step to try instant (MQTT push) updates. Note: how well this works varies by device — some devices get everything instantly, others are limited by Tuya's own restrictions (in that case the integration automatically keeps using regular polling instead, nothing breaks).

### Local Device Setup

- **Device IP Address**
- **Local Key**
- **Protocol Version**

### Cloud Configuration

- **Sensor Refresh Interval (minutes)**

### Scan to Enable Instant Updates

- **QR Code**

### Optional: Climate (Thermostat) Card

- **Enable climate card**
- **Power switch**
- **Current temperature (optional)**
- **Target temperature (optional — use it if your device has one, otherwise leave blank)**
- **Mode select (optional — only if your device can also cool)**
- **Tolerance (only used without a target temperature above)**
- **Minimum on/off cycle duration, minutes (compressor protection; only used without a target temperature above)**
- **Minimum target temperature**
- **Maximum target temperature**

### Climate Card: Heat/Cool Values

- **Value that means Heat**
- **Value that means Cool**

### After setup

- **Sensor Refresh Interval (minutes)**
- **Device IP Address**
- **Local Key**
- **Protocol Version**
- **Enable climate card**
- **Power switch**
- **Current temperature (optional)**
- **Target temperature (optional — use it if your device has one, otherwise leave blank)**
- **Mode select (optional — only if your device can also cool)**
- **Tolerance (only used without a target temperature above)**
- **Minimum on/off cycle duration, minutes (compressor protection; only used without a target temperature above)**
- **Minimum target temperature**
- **Maximum target temperature**
- **Value that means Heat**
- **Value that means Cool**

Texts from the code of [Korkuttum/tuya\_heat\_pump](https://github.com/Korkuttum/tuya_heat_pump).

## Entities

- **Selects**: Work Mode

## Troubleshooting

- **Repair notices**: Notices it can show in Settings, Repairs:
  MQTT sign-in needs to be redone

## At a glance

- Kind: Marketplace integration
- Category: [Climate](https://vulpo.app/integrations/category/climate.md), Heat pumps and air conditioning
- Brand: [Tuya](https://vulpo.app/integrations/tuya.md)
- Number: 117 installs sharing analytics; 16 GitHub stars
- Connection: Needs the vendor's cloud
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v2.6.0, last updated October 27, 2026
- Domain: `tuya_heat_pump`
- Source: <https://github.com/Korkuttum/tuya_heat_pump>
- Issues: <https://github.com/Korkuttum/tuya_heat_pump/issues>
- Screenshot: https://vulpo.app/integrations-img/fea6c7c29ad25b7c.webp (from Korkuttum/tuya\_heat\_pump's README)

In Vulpo: Quick Toggle card, Climate card, Select card, Chart card, Apple Watch, Control Center, Climate 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 |
| --- | --- | --- | --- | --- |
| [Tuya](https://vulpo.app/integrations/core/tuya.md) | Built-in integration | 166k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |
| [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 |

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/marketplace/korkuttum-tuya-heat-pump

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/korkuttum-tuya-heat-pump
- 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