Gree A/C
RobHofmann/HomeAssistant-GreeClimateComponent · v4.0.12
Custom Gree climate component written in Python3 for Home Assistant. Controls AC's supporting the Gree protocol.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
climate | Thermostat | |
sensor | Sensor (temperature, humidity, air quality…) | |
select | Mode picker (as switches) |
What people report
Local UDP control of Gree and rebranded air conditioners; newer WiFi module firmware (2.04, 2.12, 3.x) often closes local port 7000 and breaks control, while VRF and cloud support were added recently.
- Works2
- Not working5
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Gree MC31-00/F VRF module | Works Local | VRF sub-units supported, with auto discoverySaved copyAdding support for auto discovery of sub units of VRF AC. tested with my VRF module (Gree MC31-00/F). for unknown reason, not all sub units are being returned from the api, not sure if that's a bug or some kind of a limitation of the API. Excerpt saved from GitHub on 2026-10-23. | PR #376 · 2025-09 | |
| Gree units on cloud (Gree+ / EWPE) | Works Cloud | Gree Cloud support added for cloud-only unitsSaved copy… inject ourselves into the official HA container during development. It also has the advantage of having a stable and verifiable development environment. aiogree - The library: * Add support for the Humidity Control feature * Abstract the concept of a Transport * Transport has the capability to set batch_support on requests * Status requests will be batched if a single request is too large * Created `UdpTransport` for local devices * Created `MqttTransport` for cloud devices * Removed dependency on pycryptodome and used cryptography * Extract device stat Excerpt saved from GitHub on 2026-10-23. | PR #499 · 2026-09 | |
| Gree Airy firmware V2.07/V2.12 | Not working Local | Port 7000 closed on firmware 2.12; units cannot be added locallySaved copyDescribe the bug I have three Gree Airy indoor units installed on the same network. One unit is detected automatically by the integration and works perfectly. The other two units cannot be added manually. During configuration the integration always fails with: All 8 attempts failed for <ip>:7000. Error: TimeoutError Error getting device encryption key! test_connection: Got device key: None All units are visible and fully controllable in the official Gree+ application. The working unit can also be removed and added manually without any issues. The problem only affects the two other … Excerpt saved from GitHub on 2026-10-23. | Issue #468 · 2026-06 | |
| Gree Cliva / Toyotomi GTN/GTG-24CMW | Not working Local | Setup times out on newer WiFi cards; some sibling units workSaved copyThanks, that makes sense. I agree that the timeout by itself is too generic to be actionable. What seems relevant in my case is that I have three very similar Toyotomi/Gree units in the same network and environment, and only the larger GTN/GTG-24CMW fails, while the two GTN/GTG-09CMW units work fine with local communication. The main difference I found in the cloud data is: failing unit: ver: V3.2.M, hid: '' working units: ver: V3.4.M, hid: '362001065279+U-WB05RT13V1.28.bin' So my current suspicion is that this is not just a generic network timeout, but a model / Wi-Fi module / … Excerpt saved from GitHub on 2026-10-23. | Issue #405 · 2026-01 | |
| Saunier Duval VivAir Lite SDHB1-035SNWI | Not working Local | Firmware 2.04 shuts off local UDP; maintainer says by designSaved copy… that info this weekend. Platform: - OS: HAOS Core 2026.6.4 Supervisor 2026.06.2 Operating System 18.0 Frontend 20260527.7 - Gree A/C Version - 3.6.0 - Saunier Duval VivAir Lite info: Firmware Version: 2.04 Model ID: 10001 Model Version: V20.6 Logs [code] Excerpt saved from GitHub on 2026-10-23. | Issue #474 · 2026-07 | |
| Sinclair ASH-13BIS/B with CS532AE module | Not working Local | Module firmware 3.75 always times out locallySaved copyHello, First of all, thank you for maintaining this integration. I have spent several days troubleshooting a Sinclair air conditioner using the latest Gree A/C custom integration. Environment - Home Assistant 2026.7.x - Gree A/C custom integration 4.0.1 - Sinclair ASH-13BIS/B - WiFi module: CS532AE (label LTV3.56) - Module firmware: 3.75 - EWPE Smart application - Europe server (eugrih.gree.com) Network - Device has a fixed IP address. - ICMP ping works correctly. - UDP port configured as 7000. - Device is online and fully controllable from the EWPE Smart application. Cloud verification Using … Excerpt saved from GitHub on 2026-10-23. | Issue #479 · 2026-07 | |
| Sinclair Marvin SIH-12BIMW / SOH-18BIM | Not working Local | Worked until WiFi firmware 2.12 update, then local connection failsSaved copyHi everyone, I'm reaching out to request assistance with connecting or adding support for my AC unit in Home Assistant. Device Details: Brand: Sinclair Series: Marvin Model: SIH + SOH-18BIM Firmware Version: 2.12 When attempting to configure the device in Home Assistant by providing its IP address and MAC address, the connection fails and shows a connection error (Failed to connect / Device unavailable). Allthought the orginal APP sees device and I am able to operate the AC from it. I have double-checked that: The IP address is correct and static (DHCP added in router) The device is connected … Excerpt saved from GitHub on 2026-10-23. | Issue #489 · 2026-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Connection not stated
The integration doesn’t declare how it connects.
Its README mentions local or LAN control.
Details
| Installs (analytics) | 2,040 (0.29%) |
|---|---|
| GitHub stars | 528 |
| Latest version | 4.0.12 (2026-10-13) |
| Set up in the UI | Yes |
| Maintainers | @robhofmann |
| License | GPL-3.0 |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| hllhll/HomeAssistant-EKON-iAircon | ★ 15 | 2021-01-09 | EKON iAircon / Tadiran climate component written in Python3 for Home Assistant. On the bases of Gree Climate component for easier interfacing with HASS |
| goto100/HomeAssistant-GreeClimateComponent | ★ 5 | 2020-01-07 | Custom Gree climate component written in Python3 for Home Assistant. Controls AC's supporting the Gree protocol. |
| dgolovach/HomeAssistant-GreeClimateComponent-Ducted-ZoneControl | ★ 4 | 2024-11-24 | Custom Gree climate component written in Python3 for Home Assistant. Controls AC's supporting the Gree protocol. |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.