From 11d103e4657f2a75aafc9fbb237054ff68b8e94e Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Sun, 5 Apr 2026 17:06:28 -0400 Subject: [PATCH 01/19] Add Mitsubishi Comfort integration documentation Add documentation for the new mitsubishi_comfort integration which provides local control of Mitsubishi minisplit systems. --- .../_integrations/mitsubishi_comfort.markdown | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 source/_integrations/mitsubishi_comfort.markdown diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown new file mode 100644 index 000000000000..e0e7ad7d34e9 --- /dev/null +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -0,0 +1,94 @@ +--- +title: Mitsubishi Comfort +description: Instructions on how to integrate Mitsubishi minisplit systems into Home Assistant. +ha_category: + - Binary sensor + - Climate + - Sensor +ha_release: "2025.x" +ha_iot_class: Local Polling +ha_config_flow: true +ha_codeowners: + - '@nikolairahimi' +ha_domain: mitsubishi_comfort +ha_platforms: + - binary_sensor + - climate + - sensor +ha_dhcp: true +ha_integration_type: hub +ha_quality_scale: bronze +--- + +The **Mitsubishi Comfort** integration 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). + +## Prerequisites + +- A [Kumo Cloud](https://app.kumocloud.com) account with your Mitsubishi devices registered +- Devices must be connected to your local network via their Wi-Fi adapters + +{% include integrations/config_flow.md %} + +## Configuration + +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. + +After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: + +- **Connection timeout** — How long to wait when connecting to a device (default: 1.2 seconds) +- **Response timeout** — How long to wait for a device response (default: 8.0 seconds) + +## Supported devices + +| Device type | Control | Sensors | +|-------------|---------|---------| +| Indoor unit (ductless, ducted) | Mode, temperature, fan speed, vane direction | Temperature, humidity, filter status, Wi-Fi signal | +| Kumo Station (outdoor unit) | None (read-only) | Outdoor temperature, Wi-Fi signal | + +## Climate entity + +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's capabilities +- **Temperature setpoints**: Single setpoint in cool/heat modes, dual setpoints (high/low) in auto mode +- **Fan modes**: Super Quiet, Quiet, Low, Powerful, Super Powerful, Auto — number of speeds depends on the unit +- **Swing modes**: Horizontal, Mid-Horizontal, Midpoint, Mid-Vertical, Vertical, Auto, Swing — availability depends on the unit + +Temperature ranges are read from the device profile and may vary by unit and mode. + +## Sensor entities + +| Sensor | Enabled by default | Indoor | Outdoor | +|--------|-------------------|--------|---------| +| Temperature | Yes | Room temperature | — | +| Humidity | No | From external sensor or MHK2 controller | — | +| Wi-Fi signal | No | Adapter signal strength (dB) | Adapter signal strength (dB) | +| Sensor battery | No | External sensor battery level (%) | — | +| Sensor signal | No | External sensor signal strength (dB) | — | +| Outdoor temperature | No | — | Outdoor temperature | +| Uptime | No (diagnostic) | Device uptime | Device uptime | + +## Binary sensor entities + +| Sensor | Description | +|--------|-------------| +| Filter dirty | On when the unit's filter needs cleaning | + +## How it works + +1. **Setup**: The integration authenticates with Kumo Cloud to discover devices and retrieve per-device API credentials. +2. **Runtime**: All communication happens directly with the devices over your LAN using their local HTTP API. No cloud connection is needed after initial setup. +3. **Polling**: Device status is polled every 60 seconds. Commands (mode changes, temperature adjustments) are sent immediately and use optimistic state updates for responsive UI feedback. +4. **Credentials**: Device credentials are cached locally so the integration can reconnect after a restart without contacting the cloud. + +## DHCP discovery + +The integration can automatically detect Mitsubishi adapters on your network via DHCP (MAC address prefixes `24:CD:8D` and `70:87:A7`). When a device is detected, you will be prompted to set up the integration. + +## Removing the integration + +{% include integrations/remove_device_service.md %} + +Removing the integration stops all polling and closes connections to the devices. Your Kumo Cloud account and device settings are not affected. From fde49728eb6414186f5c9ff9011f798ac3fa3081 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Sun, 5 Apr 2026 17:26:22 -0400 Subject: [PATCH 02/19] Address review: fix release version, replace tables with lists - Set ha_release to 2026.5 - Replace device/sensor/binary sensor tables with lists - Remove sensor/binary_sensor from platforms (climate-only for initial PR) --- .../_integrations/mitsubishi_comfort.markdown | 30 ++----------------- 1 file changed, 3 insertions(+), 27 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index e0e7ad7d34e9..e7f13d174335 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -2,19 +2,15 @@ title: Mitsubishi Comfort description: Instructions on how to integrate Mitsubishi minisplit systems into Home Assistant. ha_category: - - Binary sensor - Climate - - Sensor -ha_release: "2025.x" +ha_release: "2026.5" ha_iot_class: Local Polling ha_config_flow: true ha_codeowners: - '@nikolairahimi' ha_domain: mitsubishi_comfort ha_platforms: - - binary_sensor - climate - - sensor ha_dhcp: true ha_integration_type: hub ha_quality_scale: bronze @@ -42,10 +38,8 @@ After setup, you can adjust the following options under **Settings** > **Devices ## Supported devices -| Device type | Control | Sensors | -|-------------|---------|---------| -| Indoor unit (ductless, ducted) | Mode, temperature, fan speed, vane direction | Temperature, humidity, filter status, Wi-Fi signal | -| Kumo Station (outdoor unit) | None (read-only) | Outdoor temperature, Wi-Fi signal | +- **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. +- **Kumo Station** (outdoor unit) — Read-only: outdoor temperature, Wi-Fi signal. ## Climate entity @@ -58,24 +52,6 @@ Each indoor unit is exposed as a climate entity with the following capabilities: Temperature ranges are read from the device profile and may vary by unit and mode. -## Sensor entities - -| Sensor | Enabled by default | Indoor | Outdoor | -|--------|-------------------|--------|---------| -| Temperature | Yes | Room temperature | — | -| Humidity | No | From external sensor or MHK2 controller | — | -| Wi-Fi signal | No | Adapter signal strength (dB) | Adapter signal strength (dB) | -| Sensor battery | No | External sensor battery level (%) | — | -| Sensor signal | No | External sensor signal strength (dB) | — | -| Outdoor temperature | No | — | Outdoor temperature | -| Uptime | No (diagnostic) | Device uptime | Device uptime | - -## Binary sensor entities - -| Sensor | Description | -|--------|-------------| -| Filter dirty | On when the unit's filter needs cleaning | - ## How it works 1. **Setup**: The integration authenticates with Kumo Cloud to discover devices and retrieve per-device API credentials. From da173904f713d00e595f2dff81917d5e70d2bdda Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:09:20 -0400 Subject: [PATCH 03/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index e7f13d174335..35faa1c7e841 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -3,7 +3,7 @@ title: Mitsubishi Comfort description: Instructions on how to integrate Mitsubishi minisplit systems into Home Assistant. ha_category: - Climate -ha_release: "2026.5" +ha_release: 2026.5 ha_iot_class: Local Polling ha_config_flow: true ha_codeowners: From 2bba12da464b57ad70780c312e043cca54e0ecfe Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:09:37 -0400 Subject: [PATCH 04/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 35faa1c7e841..3d5e6401626b 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -16,7 +16,7 @@ ha_integration_type: hub ha_quality_scale: bronze --- -The **Mitsubishi Comfort** integration 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. +The **Mitsubishi Comfort** {% term integration %} 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). From d1994faf8cb32d8b839c3238faf1162bba0f715f Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:11:11 -0400 Subject: [PATCH 05/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 3d5e6401626b..11c302c92e9e 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -29,7 +29,6 @@ This integration supports indoor units (full climate control) and Kumo Station o ## Configuration -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. After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: From 03fc9070c165c1471b439f6e3c8bc96f9c570a08 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:11:24 -0400 Subject: [PATCH 06/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 11c302c92e9e..fe2b656a609a 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -24,6 +24,7 @@ This integration supports indoor units (full climate control) and Kumo Station o - A [Kumo Cloud](https://app.kumocloud.com) 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. {% include integrations/config_flow.md %} From 6c9207e73028b0d74d37e1f24f6a4d732a79f41a Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:11:43 -0400 Subject: [PATCH 07/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index fe2b656a609a..750c8af7609c 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -33,8 +33,8 @@ This integration supports indoor units (full climate control) and Kumo Station o After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: -- **Connection timeout** — How long to wait when connecting to a device (default: 1.2 seconds) -- **Response timeout** — How long to wait for a device response (default: 8.0 seconds) +- **Connection timeout**: How long to wait when connecting to a device (default: 1.2 seconds) +- **Response timeout**: How long to wait for a device response (default: 8.0 seconds) ## Supported devices From f5a9e89bb4f8a2d5341489895acf8aeea9e0f00d Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Wed, 8 Apr 2026 10:12:29 -0400 Subject: [PATCH 08/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 750c8af7609c..9b7679341242 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -28,7 +28,6 @@ This integration supports indoor units (full climate control) and Kumo Station o {% include integrations/config_flow.md %} -## Configuration After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: From 67703a9c8555dc96c7fc8066e82355999832bf5c Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 9 Apr 2026 08:31:09 +0200 Subject: [PATCH 09/19] remove extra newlines --- source/_integrations/mitsubishi_comfort.markdown | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 9b7679341242..b43fd1d30795 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -28,8 +28,6 @@ This integration supports indoor units (full climate control) and Kumo Station o {% include integrations/config_flow.md %} - - After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: - **Connection timeout**: How long to wait when connecting to a device (default: 1.2 seconds) From c7b9aa173ec7753b963e76e4a90dbd2287144561 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:12:40 -0400 Subject: [PATCH 10/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index b43fd1d30795..12f09ffdba5c 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -11,7 +11,6 @@ ha_codeowners: ha_domain: mitsubishi_comfort ha_platforms: - climate -ha_dhcp: true ha_integration_type: hub ha_quality_scale: bronze --- From 5d4c65465becf288b1ace08ae52ec3b4144e99c0 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:12:52 -0400 Subject: [PATCH 11/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 3 --- 1 file changed, 3 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 12f09ffdba5c..de380003a28b 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -55,9 +55,6 @@ Temperature ranges are read from the device profile and may vary by unit and mod 3. **Polling**: Device status is polled every 60 seconds. Commands (mode changes, temperature adjustments) are sent immediately and use optimistic state updates for responsive UI feedback. 4. **Credentials**: Device credentials are cached locally so the integration can reconnect after a restart without contacting the cloud. -## DHCP discovery - -The integration can automatically detect Mitsubishi adapters on your network via DHCP (MAC address prefixes `24:CD:8D` and `70:87:A7`). When a device is detected, you will be prompted to set up the integration. ## Removing the integration From 7d021c0f3a1d67b068d2685ba6c4acff9b53b6d7 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:13:04 -0400 Subject: [PATCH 12/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index de380003a28b..b058fd4beab6 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -27,11 +27,6 @@ This integration supports indoor units (full climate control) and Kumo Station o {% include integrations/config_flow.md %} -After setup, you can adjust the following options under **Settings** > **Devices & services** > **Mitsubishi Comfort** > **Configure**: - -- **Connection timeout**: How long to wait when connecting to a device (default: 1.2 seconds) -- **Response timeout**: How long to wait for a device response (default: 8.0 seconds) - ## Supported devices - **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. From 41f7134394e2d1a5399c38d0f6adbdfe9fe086cf Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:14:04 -0400 Subject: [PATCH 13/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index b058fd4beab6..925096307483 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -32,7 +32,7 @@ This integration supports indoor units (full climate control) and Kumo Station o - **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. - **Kumo Station** (outdoor unit) — Read-only: outdoor temperature, Wi-Fi signal. -## Climate entity +### Climate Each indoor unit is exposed as a climate entity with the following capabilities: From 7c6cfe3a8d4704eb56fe5509225c5369dc8ef027 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:14:15 -0400 Subject: [PATCH 14/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 925096307483..d18238a82372 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -36,10 +36,14 @@ This integration supports indoor units (full climate control) and Kumo Station o 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's capabilities -- **Temperature setpoints**: Single setpoint in cool/heat modes, dual setpoints (high/low) in auto mode -- **Fan modes**: Super Quiet, Quiet, Low, Powerful, Super Powerful, Auto — number of speeds depends on the unit -- **Swing modes**: Horizontal, Mid-Horizontal, Midpoint, Mid-Vertical, Vertical, Auto, Swing — availability depends on the unit +- **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. Temperature ranges are read from the device profile and may vary by unit and mode. From 30323b1585db7cf961783efee8e8890f71d5a733 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:14:32 -0400 Subject: [PATCH 15/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index d18238a82372..888250441223 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -1,6 +1,6 @@ --- title: Mitsubishi Comfort -description: Instructions on how to integrate Mitsubishi minisplit systems into Home Assistant. +description: Integrate Mitsubishi Electric ductless minisplit heat pump and air conditioning systems with Home Assistant. ha_category: - Climate ha_release: 2026.5 From a7e63f67a795108a84eafbe3fc65d99c601bdcd5 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:14:47 -0400 Subject: [PATCH 16/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 888250441223..9ea82f3199bf 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -31,7 +31,9 @@ This integration supports indoor units (full climate control) and Kumo Station o - **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. - **Kumo Station** (outdoor unit) — Read-only: outdoor temperature, Wi-Fi signal. +## Supported functionality +The **Mitsubishi Comfort** integration provides the following entities. ### Climate Each indoor unit is exposed as a climate entity with the following capabilities: From 37c0b204c662f0ea2f490ca007789373a39f7e0a Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:31:22 -0400 Subject: [PATCH 17/19] Address review: rework How it works into Data updates Replace the non-standard How it works section with the canonical Data updates section using the polling glossary term. The setup, runtime, and credentials bullets duplicated content already in the introduction. Also fix missing blank lines before the Supported functionality and Climate headings, and drop the redundant second mention of temperature ranges. --- source/_integrations/mitsubishi_comfort.markdown | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 9ea82f3199bf..4dfdbce93471 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -31,9 +31,11 @@ This integration supports indoor units (full climate control) and Kumo Station o - **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. - **Kumo Station** (outdoor unit) — Read-only: outdoor temperature, Wi-Fi signal. + ## Supported functionality The **Mitsubishi Comfort** integration provides the following entities. + ### Climate Each indoor unit is exposed as a climate entity with the following capabilities: @@ -47,15 +49,9 @@ Each indoor unit is exposed as a climate entity with the following capabilities: - **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. -Temperature ranges are read from the device profile and may vary by unit and mode. - -## How it works - -1. **Setup**: The integration authenticates with Kumo Cloud to discover devices and retrieve per-device API credentials. -2. **Runtime**: All communication happens directly with the devices over your LAN using their local HTTP API. No cloud connection is needed after initial setup. -3. **Polling**: Device status is polled every 60 seconds. Commands (mode changes, temperature adjustments) are sent immediately and use optimistic state updates for responsive UI feedback. -4. **Credentials**: Device credentials are cached locally so the integration can reconnect after a restart without contacting the cloud. +## Data updates +The Mitsubishi Comfort integration {% term polling polls %} 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. ## Removing the integration From 384d522eb3292cb561098dd21c317173c2458bb1 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Thu, 9 Apr 2026 18:35:00 -0400 Subject: [PATCH 18/19] Address review: nest supported devices list Replace the flat Supported devices bullets with a nested structure so the indoor unit's controls and sensors are visible at a glance, matching the nested pattern used in the Climate section. --- source/_integrations/mitsubishi_comfort.markdown | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index 4dfdbce93471..ab3231645fd1 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -29,8 +29,11 @@ This integration supports indoor units (full climate control) and Kumo Station o ## Supported devices -- **Indoor unit** (ductless, ducted) — Full climate control: mode, temperature, fan speed, vane direction. Sensors: temperature, humidity, filter status, Wi-Fi signal. -- **Kumo Station** (outdoor unit) — Read-only: outdoor temperature, Wi-Fi signal. +- **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 ## Supported functionality From 10a442a0c57008fe0b37dfe6b5d799fd63313bf2 Mon Sep 17 00:00:00 2001 From: Nikolai Rahimi Date: Fri, 10 Apr 2026 08:47:05 -0400 Subject: [PATCH 19/19] Update source/_integrations/mitsubishi_comfort.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mitsubishi_comfort.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown index ab3231645fd1..22f561d4452d 100644 --- a/source/_integrations/mitsubishi_comfort.markdown +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -45,7 +45,7 @@ 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 +- **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.