Skip to content
Home Assistant TestFlight
Climate

Gree A/C

RobHofmann/HomeAssistant-GreeClimateComponent · v4.0.12

HACSConnection not stated

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.

EntityShows up asNote
switchSwitch or outlet
climateThermostat
sensorSensor (temperature, humidity, air quality…)
selectMode 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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Gree MC31-00/F VRF moduleWorks LocalVRF sub-units supported, with auto discovery
Saved copy
Adding 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 CloudGree Cloud support added for cloud-only units
Saved 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.12Not working LocalPort 7000 closed on firmware 2.12; units cannot be added locally
Saved copy
Describe 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-24CMWNot working LocalSetup times out on newer WiFi cards; some sibling units work
Saved copy
Thanks, 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-035SNWINot working LocalFirmware 2.04 shuts off local UDP; maintainer says by design
Saved 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 moduleNot working LocalModule firmware 3.75 always times out locally
Saved copy
Hello, 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-18BIMNot working LocalWorked until WiFi firmware 2.12 update, then local connection fails
Saved copy
Hi 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 stars528
Latest version4.0.12 (2026-10-13)
Set up in the UIYes
Maintainers@robhofmann
LicenseGPL-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.

ForkStarsLast pushDescription
hllhll/HomeAssistant-EKON-iAircon★ 152021-01-09EKON 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★ 52020-01-07Custom Gree climate component written in Python3 for Home Assistant. Controls AC's supporting the Gree protocol.
dgolovach/HomeAssistant-GreeClimateComponent-Ducted-ZoneControl★ 42024-11-24Custom 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.