MELCloud


The melcloud integration integrates Mitsubishi Electric’s MELCloud enabled devices into Home Assistant.

Device support

  • Air-to-Air heat pumps, e.g., AC units - Supported
  • Air-to-Water heat pumps - Supported
  • Energy recovery ventilators - Not supported
  • Other - Not supported

Configuration

The integration should be configured through the user interface (“Configurations -> Integrations”) using the MELCloud login details. While not optimal, the provided password is not stored.

An expired token needs to be updated manually by adding the MELCloud integration again with the same email address.

Configuration is also possible through configuration.yaml. The required authentication token can be found in X-MitsContextKey header when logged into the MELCloud. The language needs to be set to English and the “Remember me” option needs to be selected.

melcloud:
  username: [email protected]
  token: xxxxxxxxxxxxxxxxxxx

Configuration Variables

username

(string)(Required)

Email address used to login to MELCloud

token

(string)(Required)

X-MitsContextKey access token

Air-to-Air device

An Air-to-Air heat pump provides climate and sensor platforms. Device capabilities can limit the available parameters and sensors.

Climate

The following parameters can be controlled for the climate platform entities:

  • Power (using HVAC mode)
  • Target temperature
  • Operation mode (HVAC mode)
  • Fan speed

Sensor

The following attributes are available for sensor platform entities:

  • Room temperature
  • Energy - The total consumed energy in kWh. Not supported by all models.

Air-to-Water device

An Air-to-Water device provides water_heater, climate and sensor platforms.

Climate

A climate platform entity is provided for each radiator zone in the air-to-water system. The following parameters can be controlled:

  • Target room temperature

The radiators need to be configured to run in room temperature control mode either through the local HMI or MELCloud. Flow temperature and curve modes are not supported.

Some air-to-water devices allow cooling using the radiator zones. This feature has not been implemented due to the lack of sample devices.

The system cannot be turned on/off through the climate entities.

State attributes

Attribute Description Example
status Current operation status idle

Sensor

The following attributes are available for sensor platform entities:

  • Room temperature for each zone
  • Tank water temperature
  • Outside temperature - 1°C precision, polled every 1-2 hours.

Unlike air-to-air devices, air-to-water devices do not report energy consumption in an easily accessible manner.

Water heater

The following parameters can be controlled for the water_heater platform entities:

  • Power - Controls the entire system.
  • Target tank temperature
  • Operation mode

State attributes

Attribute Description Example
status Current operation status heat