MELCloud Home - Custom Integration for New Mitsubishi WiFi Adapters
I recently bought a Mitsubishi air conditioning system and discovered the new MELCloud Home platform isn’t supported by Home Assistant. The existing MELCloud integration only works with the legacy platform, which uses a completely different API.
I’ve reverse engineered the MELCloud Home web application and built a custom integration that works with the new system.
Repository: GitHub - andrew-blake/melcloudhome: Melcloudhome Home Assistant Integration
Installation:
Available via HACS as a custom repository. Add the repository URL and install like any other custom integration.
Tested Hardware:
-
MAC-597 adapter (multi-split ATA system)
-
MAC-577 adapter (confirmed by user)
-
MAC-567 adapter (confirmed by user)
Features:
-
HVAC control (temperature, modes, fan speed, vane positions)
-
Energy monitoring with persistent storage
-
Sensors for room temperature, WiFi signal, and error states
-
Integration with Home Assistant’s Energy Dashboard
Known Limitations:
Multi-split systems sometimes report odd or missing energy values in the official MELCloud Home app itself. The integration can only show what the API provides, so you might see the same quirks in Home Assistant.
Technical Details:
The integration handles AWS Cognito OAuth authentication and polls the MELCloud Home REST API. The API client is currently bundled with the integration but could be extracted to a separate PyPI module if there’s interest in using it for other projects.
Source Code:
All code is available on GitHub with comprehensive test coverage. Contributions welcome.
If you give it a try, I’d appreciate hearing how it works with your setup, particularly if you have different adapter models or indoor unit configurations.