diff --git a/source/_integrations/mitsubishi_comfort.markdown b/source/_integrations/mitsubishi_comfort.markdown new file mode 100644 index 000000000000..22f561d4452d --- /dev/null +++ b/source/_integrations/mitsubishi_comfort.markdown @@ -0,0 +1,63 @@ +--- +title: Mitsubishi Comfort +description: Integrate Mitsubishi Electric ductless minisplit heat pump and air conditioning systems with Home Assistant. +ha_category: + - Climate +ha_release: 2026.5 +ha_iot_class: Local Polling +ha_config_flow: true +ha_codeowners: + - '@nikolairahimi' +ha_domain: mitsubishi_comfort +ha_platforms: + - climate +ha_integration_type: hub +ha_quality_scale: bronze +--- + +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). + +## 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 +- 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 %} + +## 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 + +## 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 {% 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 + +{% 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.