Skip to content
A Home Assistant custom component for use with ECHONET enabled Mitsubishi HVAC systems.
Branch: master
Clone or download
scottyphillips Update
Fixed a typo in the comments.
Latest commit b1ff5a4 Jan 3, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom_components/mitsubishi Update Jan 3, 2020
ECHONET.jpeg More work on readme. Oct 7, 2019
Mitsubishi.jpg Fix issue 4 Nov 18, 2019
hacs.json Tweaks to Repo Oct 7, 2019 Update Nov 28, 2019

Mitsubishi ECHONET Climate Component for Home Assistant

GitHub Release License hacs Project Maintenance BuyMeCoffee

A Home Assistant custom component for use with ECHONET enabled Mitsubishi HVAC systems using the MAC-568IF-E WiFi Adaptor. This custom component makes use of the 'mitsubishi_echonet' Python library also written by yours truly: (

This component will set up the climate platform.

Current working systems:

Based upon feedback this custom component works on the following Mitsubishi HVAC systems all equipped with the MAC-568IF-E WiFi Adaptor: MSZ-GE42VAD MSZ-GE24VAD MSZ-GL50VGD MSZ-GL35VGD PEA-RP140GAA

Installation - Enable ECHONET protocol

This Custom Component makes use of the official Mitsubishi MAC-568IF-E WiFi Adaptor. Other adaptors (indeed other vendors!) may work, but they must support the 'ECHONET lite' protocol.

From the official Mitsubishi AU/NZ Wifi App, you will need to enable the 'ECHONET lite' protocol under the 'edit unit' settings.


Installation - Home Assistant

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called mitsubishi.
  4. Download all the files from the custom_components/mitsubishi/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. Add climate: to your HA configuration as per the example below.

Using your HA configuration directory (folder) as a starting point you should now also have this:


Example configuration.yaml

  - platform: mitsubishi

Configuration options

Key Type Required Description
ip_address string True IP Address for the HVAC system.
name string False Friendly name for the HVAC system
climate list False Configuration for the climate platform.

Configuration options for climate list

Key Type Required Default Description
fan_modes list False True Fine tune fan settings.

Fine tuning fan settings.

Optionally, you can also specify what fan settings work with your specific HVAC system. If no fan speeds are configured, the system will default to 'low' and 'medium-high'. Just delete the ones you don't need. A bit of trial and error might be required here.

  - platform: mitsubishi
    name: "mitsubishi_ducted"
      - 'minimum'
      - 'low'
      - 'medium-low'
      - 'medium'
      - 'medium-high'
      - 'high'
      - 'very-high'
      - 'max'

Comments and suggestions are welcome!


Thanks to Dick Swart and Alfie Gerner who have both contributed code and great ideas in support of this project.

Thanks to Jeffro Carr who inspired me to write my own native Python ECHONET library for Home Assistant. I could not get his Node JS Docker container to work properly on :-) Some ideas in his own repo got implemented in my own code. (

Also big thanks to Futomi Hatano for open sourcing a high quality and extremely well documented ECHONET Lite library in Node JS that formed the basis of my reverse engineering efforts. (


This application is licensed under an MIT license, refer to LICENSE for details.

You can’t perform that action at this time.