Mitsubishi Comfort

The Mitsubishi Comfort integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] connects Mitsubishi Electric ductless minisplit heat pump and air conditioning systems to Home Assistant. It communicates directly with each indoor unit over your local network for low-latency control, using the Kumo Cloud account only for initial device discovery and credential retrieval.

This integration supports indoor units (full climate control) and Kumo Station outdoor units (temperature monitoring only).

Supported devices

• Indoor unit (ductless, ducted)
  • Controls: mode, temperature, fan speed, vane direction
  • Sensors: temperature, humidity, filter status, Wi-Fi signal
• Kumo Station (outdoor unit, read-only)
  • Sensors: outdoor temperature, Wi-Fi signal

Prerequisites

• A Kumo Cloud account with your Mitsubishi devices registered
• Devices must be connected to your local network via their Wi-Fi adapters
• During setup you will be asked to enter the username and password for your Kumo Cloud account. The integration uses these credentials to discover your devices and retrieve the local API passwords needed for direct communication.

Configuration

To add the Mitsubishi Comfort hub to your Home Assistant instance, use this My button:

Mitsubishi Comfort can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Finding device IP addresses

The Kumo Cloud account provides the device list and credentials, but never a device’s local IP address. The integration finds each address automatically through DHCP discovery—including devices that were already seen on the network before the integration was set up—and records the new address when a device’s IP changes. Automatic discovery works when your devices are on the same network as Home Assistant.

If a device is on a different subnet or VLAN, DHCP discovery cannot reach it. The device then has no entities yet, and the integration raises a repair issue where you can enter the IP address manually:

1. Go to Settings > System > Repairs.
2. Select the Mitsubishi Comfort devices have no local IP address issue.
3. Enter the local IP address for each listed device. Each field is labeled with the device’s MAC address.
4. Leave a field blank to keep waiting for DHCP discovery for that device.

Supported functionality

The Mitsubishi Comfort integration provides the following entities.

Climate

Each indoor unit is exposed as a climate entity with the following capabilities:

• HVAC modes: Off, Cool, Heat, Dry, Fan only, Heat/Cool (auto)
  • Availability depends on the specific unit.
• Fan modes: Super quiet, Quiet, Low, Powerful, Super powerful, Auto
  • The number of available speeds depends on the unit.
• Swing modes: Horizontal, Mid-Horizontal, Midpoint, Mid-Vertical, Vertical, Auto, Swing
  • Availability depends on the unit.
• Temperature: Single setpoint in Cool and Heat modes, separate high and low setpoints in Heat/Cool (auto) mode.
  • Temperature ranges vary by unit and mode.

Data updates

The Mitsubishi Comfort integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the status of your devices every 60 seconds. When you send a command (such as changing the mode or adjusting the temperature), Home Assistant reflects the change straight away, without waiting for the next poll.

Troubleshooting

Devices show up without entities or stay unavailable

A device has no entities until its local IP address is known. The integration normally finds the address through DHCP discovery, which only works when the device is on the same network as Home Assistant. While any device lacks an address, the integration raises a repair issue where you can enter it manually. See Finding device IP addresses.

Removing the integration

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.

Removing the integration stops all polling and closes connections to the devices. Your Kumo Cloud account and device settings are not affected.