Skip to main content

MELCloud Home integration for Gladys Assistant

MELCloud Home integration for Gladys Assistant

Control your Mitsubishi Electric air conditioners through the MELCloud Home cloud.

View on GitHubAll external integrations

Control your Mitsubishi Electric air conditioners through the MELCloud Home cloud.

Requirements​

  • A MELCloud Home account (melcloudhome.com) — the new Mitsubishi Electric platform. If your account was created on the legacy MELCloud (app.melcloud.com), it will not work here: the two platforms are separate.
  • Your air conditioners already added to your MELCloud Home account (via the MELCloud Home mobile app).

Configuration​

  1. Enter the email and password of your MELCloud Home account. They are stored encrypted by Gladys and used only to authenticate against MELCloud Home.
  2. Optionally adjust the refresh interval (how often the state is polled).
  3. Save. Use Test the connection to confirm your credentials.

Adding your devices​

Run a device discovery: every unit on your account appears, ready to create.

  • Air-to-air units (air conditioners) expose four features — Power, Mode (heat / cool / dry / fan / auto), Target temperature and a read-only Room temperature.
  • Air-to-water units (Ecodan heat pumps) expose Power, a Zone 1 temperature setpoint and read-only Zone 1 room temperature, an Outdoor temperature sensor, and — when a hot water tank is present — Hot water temperature (setpoint), a read-only Hot water tank temperature and a Forced hot water switch.

Create the ones you want to control.

Notes​

  • Air-to-air (air conditioners) and air-to-water (Ecodan heat pumps) units are supported. ERV ventilation units are ignored.
  • Zone operation mode (heating curve, flow vs room thermostat) is not controllable yet on air-to-water units.
  • The connection status is shown on this screen; if it reports a login failure, re-check your email and password.

Configuration settings​

These are the settings MELCloud Home asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
MELCloud Home accountsectionNoMELCloud Home (melcloudhome.com) is the new Mitsubishi Electric platform, separate from the legacy MELCloud. Sign in with the same email and password you use in the MELCloud Home app.
EmailstringYesThe email address of your MELCloud Home account.
PasswordsecretYesThe password of your MELCloud Home account (stored encrypted).
Refresh interval (s)numberNoHow often the air conditioners state is refreshed, in seconds.

How to install MELCloud Home in Gladys​

  1. In Gladys, open Integrations: MELCloud Home appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/callemand/gladys-melcloud-home:1.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/callemand/gladys-melcloud-home.

MELCloud Home requires Gladys >=4.62.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

MELCloud Home is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by callemand, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on