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.
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.
Hi, thanks for the effort it is highly appreciated and works great on my setup!
I have two duo-multisplit systems (so 4 MSZ-AY indoor units on 2 MXZ outdoor units).
After discovering, that one of the Wifi units is a MAC-597 while the others are MAC-577 I needed to switch to MELCloud Home and luckily found your solution!
I am now tinkering with Helper sensors to build one sensor summing up total energy of all four units for the Energy Dashboard and to find a way to derive Power Consumption from that one combined Energy sensor.
Maybe someone has a working solution ready here?
The App propably does not propagate a Power sensor, am I right?
Thank you so much for this! Want a beer? Was about to try and write something myself but luckily found this… I’m now in bed and haven’t tried it more than adding the device, which worked.
Today, I had them install a Mitsubishi Energy Ninja FT25 (MSZ-FT25VGK2) with the included wifi module MAC-597IFB-E.
Thank you so much for this! I can confirm it works great with the following:
Wi-Fi Adapter: MAC-597IFB-E
Outdoor Unit: MXZ-2F42VF4
Indoor Unit: MSZ-AY35VGK2-E1
I don’t see any energy related values yet, but I also don’t see them on the MELCloud Home itself. I’ll wait for a couple days and ask Mitsubishi support if the data does not appear on the oficial app.
I have a control issue in Home Assistant. When I set heating or cooling, only the indoor unit turns on (with a stable power consumption of around 13 watts).
In the MELCloud Home app, I can see that the settings are being applied correctly. However, the outdoor unit does not start.
Only when I manually select heating or cooling again in the MELCloud Home app does the outdoor unit turn on, and the system actually starts heating or cooling.
Other settings, such as fan speed, do work properly.
Are there more people experiencing this issue?
