Custom integration for Home Assistant that adds support for cloud-only Gree devices via the Gree+ app and cloud MQTT broker.
This integration is based on a fork of the greeclimate library with added cloud support.
π Quick Start: New to this integration? Check out the Quick Start Guide to get up and running in 5 minutes!
- π Cloud-only device support - Works with Gree devices that only communicate via cloud
- π Full climate control - Temperature, mode, fan speed, swing modes
- οΏ½οΈ Hot water heat pump support - Control Gree WHIO / Hot Water Heat Pump devices
- ποΈ Additional switches - Panel light, quiet mode, fresh air, XFan, health mode (AC/heat pump devices)
- π Secure authentication - Uses your existing Gree+ account credentials
- π Multi-region support - Works with all Gree Cloud regions
Any Gree Smart air conditioner or heat pump working with the Gree+ app should be supported, including non-Gree branded devices such as:
- Trane
- Innova
- Cooper & Hunter
- Proklima
- Tadiran
- Heiwa
- Ekokai
- Lessar
- Tosot
- Wilfa
- Gree WHIO (New Zealand)
- Gree Hot Water Heat Pump (Australia)
- Open HACS in Home Assistant
- Go to "Integrations"
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add this repository URL:
https://github.com/davo22/homeassistant-gree-cloud - Select category: "Integration"
- Click "Add"
- Search for "Gree Climate Cloud" and install
- Restart Home Assistant
- Copy the
custom_components/gree_cloudfolder to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- Go to Settings β Devices & Services
- Click + Add Integration
- Search for "Gree Climate Cloud"
- Select your server region (e.g., Europe, North American, etc.)
- Enter your Gree+ account credentials (username/email and password)
- Click Submit
The integration will automatically discover all devices associated with your Gree+ account.
Created for standard Gree air conditioner and heat pump devices:
- HVAC Modes: Off, Auto, Cool, Heat, Dry, Fan Only
- Preset Modes: None, Eco, Away (8Β°C mode), Boost (Turbo), Sleep
- Fan Modes: Auto, Low, Medium Low, Medium, Medium High, High
- Swing Modes: Off, Vertical, Horizontal, Both
- Temperature Control: Target temperature with 1Β° step
Created for Gree WHIO / Hot Water Heat Pump devices (auto-detected):
- Operation Modes: Heat Pump (normal), Performance (boost), Off
- Temperature Control: Target temperature 40β80Β°C with 1Β° step
- Current Temperature: Live tank water temperature
Created for air conditioner and heat pump devices only (not hot water heat pumps):
- Panel Light: Control the front panel LED
- Quiet Mode: Enable/disable quiet operation
- Fresh Air: Enable/disable fresh air intake
- XFan: Enable/disable extra fan mode (helps dry coils)
- Health Mode: Enable/disable anion/health mode (disabled by default)
Select the appropriate region for your account:
- Australia
- China Mainland
- East South Asia
- Europe
- India
- Latin American
- Middle East
- North American
- Russia
- South American
- Cloud polling: The integration polls the cloud every 60 seconds for state updates. Local changes may take up to a minute to reflect in Home Assistant.
- Internet required: Devices must be connected to the internet and the Gree Cloud for this integration to work.
- No local control: This integration does not support local UDP communication. For local-only devices, use the official Gree integration.
- Verify your Gree+ credentials are correct
- Ensure you selected the correct server region
- Check that your account has devices registered in the Gree+ app
- Ensure devices are online in the Gree+ app
- Try reloading the integration
- Check Home Assistant logs for error messages
- Check if device is online in Gree+ app
- Verify internet connectivity
- Look for timeout errors in logs
- Try reloading the integration
- This is normal - cloud polling occurs every 60 seconds
- For immediate feedback, check the Gree+ app
- Consider using local integration for local devices
Add this to your configuration.yaml:
logger:
default: info
logs:
custom_components.gree_cloud: debug
greeclimate: debugA: The official integration only works with devices that support local UDP communication. This cloud integration works with cloud-only devices that can only be controlled via the Gree Cloud MQTT broker. If your device works with the official integration, use that instead for better responsiveness.
A: Yes! You can use both integrations simultaneously. Use the official integration for local devices and this cloud integration for cloud-only devices.
A: The integration polls the cloud every 60 seconds. Changes made in the Gree+ app or locally on the device will be reflected in Home Assistant within 1 minute.
A: No, this integration requires an active internet connection to communicate with the Gree Cloud servers.
A: Currently, the integration defaults to CipherV1 (AES-128-ECB) which works with most devices. CipherV2 support is implemented but not yet exposed in the UI.
A: This can happen if:
- The device is offline or not connected to WiFi
- Your internet connection is unstable
- The Gree Cloud servers are experiencing issues
- The device was removed from your Gree+ account
Try power-cycling the device and ensuring it's connected in the Gree+ app.
A: Yes! The integration automatically discovers all devices associated with your Gree+ account across all homes.
A: Yes, the integration detects the temperature unit set on your device and displays temperatures accordingly.
- Original greeclimate library by @cmroche
- Cloud API implementation based on gree-api-client
- Official Home Assistant Gree integration
MIT License - see LICENSE file for details