About
Gree A/C is a climate integration that controls air conditioners supporting the Gree protocol. It talks to the units directly over their IP address on the local network, rather than through Gree's servers like the mobile app does after initial setup. Besides the climate entity, it adds a temperature step number, an external temperature sensor selector, outside temperature and room humidity sensors, and switches for features such as X-Fan, lights, health, power save, sleep and anti direct blow. Options cover HVAC modes, fan modes, vertical and horizontal swing modes, a temperature sensor offset and an availability check toggle. Setup runs in the UI with discovery or manual entry, and devices on other VLANs can be found by entering networks or host addresses.
Automatic summary of the README and code of RobHofmann/HomeAssistant-GreeClimateComponent. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Climate
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Gree Climate Setup
- Setup Method
Manual Setup
- Name
- IP Address
- Port
- MAC Address
- Encryption Key
- UID
- Encryption Version
Cross-VLAN Discovery
- Networks (comma-separated CIDRs, e.g. 192.168.30.0/24)
- Hosts (comma-separated IPs, e.g. 192.168.30.50,192.168.30.51)
Discovered Devices
- Device
Configure Device
- Device Name
After setup
- HVAC Modes
- Fan Modes
- Vertical Swing Modes
- Horizontal Swing Modes
- Disable Available Check
- Temperature Sensor Offset
Texts from the code of RobHofmann/HomeAssistant-GreeClimateComponent.
Entities
- NumbersTemperature Step
- SelectsExternal Temperature Sensor
- SensorsOutside Temperature, Room Humidity
- SwitchesHalf-degree via Add0.5, X-Fan, Lights, Health, Power Save, 8°C Heat, Sleep, Air, Auto X-Fan, Auto Light, Anti Direct Blow, Light Sensor, and 1 more
From the README
Custom Gree climate component written in Python3 for Home Assistant. Controls ACs supporting the Gree protocol.
For a comprehensive list of tested devices, see Supported Devices.
Shows in Vulpo
Quick Toggle card, Climate card, Select card, Chart card, Apple Watch, Control Center, Climate Live Activity.Information
- Installs
- 2k sharing analytics
- GitHub stars
- 528
- Connection
- Not stated
- Upkeep
- Updated in the last 6 months
- Version
- 4.0.12,
- Category
- Climate, Heat pumps and air conditioning
- Kind
- Marketplace integration
- Brand
- Gree
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
gree- Issues
- Report an issue











