[Custom Integration] MELCloud Home for New Mitsubishi WiFi Adapters

Share your Projects! Custom Integrations
1

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.

4 Likes
2

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?

3

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.

4

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.