Mitsubishi WF-RAC for Home Assistant (Marketplace integration)

Installs: 2.1k sharing analytics
GitHub stars: 306
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2026.10.1, October 26, 2026
Category: Climate, Heat pumps and air conditioning
Kind: Marketplace integration
Brand: Mitsubishi
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: mitsubishi_wf_rac
Source: github.com/blues-sechseck/Mitsubishi-WF-RAC-Integration
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Mitsubishi WF-RAC is an integration for Mitsubishi Heavy Industries air conditioners that use the WF-RAC WiFi module. It talks to the module's local HTTP API, so control stays on the local network, and units on the network are found automatically. It adds a climate entity plus sensors, binary sensors, a silent operation switch, swing and fan speed selects, and an energy total that can be reset. Units that report the capability also get Home Leave Mode numbers and selects. Options cover temperature offsets, overshoot correction for cooling, dry and heating, and an outside room temperature sensor for the unit to regulate on. An optional firmware update check is the only connection to the internet and is off by default. It does not work with Mitsubishi Electric systems or MELCloud.

Automatic summary of the README and code of blues-sechseck/Mitsubishi-WF-RAC-Integration. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Climate
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

WF-RAC AC connection info

HostThe local IP address of the airco's wireless module. A changed address is picked up when the module announces itself again; give the module a fixed address in your router, or correct it here if it does not.
PortThe port the module's local API listens on. Leave this at 51443 unless your module announces a different one.
Ignore duplicate IP addressAdd this airco even though another entry already uses this IP address. Meant for re-adding a unit whose old entry went missing: the module accepts one connection at a time, so two entries polling it will produce errors in the log.

Discovered WF-RAC airco

PortThe port to reach the module on. It is normally 51443 - correct it here if the announced value above looks different.

Reconfigure WF-RAC AC connection

HostThe local IP address of the airco's wireless module. A changed address is picked up when the module announces itself again; give the module a fixed address in your router, or correct it here if it does not.
PortThe port the module's local API listens on. Leave this at 51443 unless your module announces a different one.

After setup

Retry limitConsecutive failed polls before the airco is marked unavailable. The minimum of three is about three minutes at the 60-second poll interval - enough to ride through the module's hourly WiFi reassociation. Raise it on a weak link.
Check for firmware updatesAdds a Firmware Update entity that compares the module's version against the manufacturer's server. This is the only outbound internet connection the integration makes - leave it off to stay fully local.
SensorThe unit regulates on this sensor. Leave it empty to put the unit back on its own sensor. Unavailable or unknown states do the same on the next frame. In heat mode most units add 2 °C to the setting on their own, which a sensor out in the room makes visible - the README says how to switch that off at the unit.
Cooling overshootHow far the room goes past your setting before the unit stops. Set 22 °C and the room settles at 21.5 °C: enter 0.5. Starts at 0.5 because that is what the units measured so far need - check where your own room settles and adjust. If it stops short instead and never gets cold enough, enter a negative number. Quarter degrees are the finest step that reaches the unit. Applies in cool mode only - dry has a field of its own, and in auto the unit is handed your reading uncorrected.
Dry overshootThe same for dry, which cools as well and takes the same sign. Opens on 0: the one unit measured in this mode landed on its setting, with a wider band than in cooling. If yours goes past it, set a target, let the room settle, and enter how far past it the room went.
Heating overshootThe same for heating, and in heat mode only: positive if the room ends up above your setting, negative if it stops short of it.
Target Temp. OffsetPositive lowers the setting sent to the unit, negative raises it - the card keeps showing yours either way. Most units round a half degree up to the next whole one, so 0.5 here often acts as 1. With an Indoor temperature source in use, the cooling overshoot above is the lever for a unit that overshoots - it is finer, and it leaves the setpoint matching the app.
Target Temp. Offset (Cooling)Leave empty to use the general target temperature offset.
Target Temp. Offset (Heating)Leave empty to use the general target temperature offset.
Indoor Temp. Sensor OffsetAdded to the unit's own indoor reading before it is shown. Display only - it does not change what the unit does.
Outdoor Temp. Sensor OffsetThe same, for the outdoor temperature the unit reports.

Texts from the code of blues-sechseck/Mitsubishi-WF-RAC-Integration.

Entities

Binary sensorsProblem, Presence, Compressor demand, External control, Indoor temperature override, Defrosting
ButtonsReset energy usage total
NumbersHome Leave cooling outdoor temperature threshold, Home Leave cooling target room temperature, Home Leave heating outdoor temperature threshold, Home Leave heating target room temperature
SelectsHorizontal swing direction, Vertical swing direction, Fan speed, Home Leave mode, Home Leave cooling air flow, Home Leave heating air flow
SensorsIndoor, Outdoor, Target, Airco ID, Operator ID, Device ID, IP address, Connected accounts, Error, Updated by, Account expires, LED status, and 22 more
SwitchesSilent operation
UpdatesFirmware update

Actions

Set horizontal swing modeSets the horizontal (left/right) swing mode.Fields: Horizontal swing mode
Set vertical swing modeSets the vertical (up/down) swing mode.Fields: Vertical swing mode
Request Home Leave Mode statusAsks the unit to report its current Home Leave Mode thresholds/airflow. Call once so the number/select entities have a value to show and edit - the unit omits them from a plain poll otherwise. Only supported on models with the HomeLeaveMode capability.
Set Home Leave ModeWrites new Home Leave Mode thresholds/airflow for cooling and heating. Only supported on models with the HomeLeaveMode capability.Fields: Cooling temp rule, Cooling temp setting, Cooling airflow, Heating temp rule, Heating temp setting, Heating airflow
Set indoor temperatureArms a room temperature for the AC to regulate on instead of the one its own indoor sensor reads. The value is not sent by this action; it rides along on the next frame that goes out anyway, so it takes effect within a minute. While an override is armed the integration asks the unit for one operation data segment per cycle, which is the frame that carries it. Omit the temperature to revert to the internal room sensor.Fields: Temperature
Set Energy Usage TotalOverwrites the accumulated Energy Usage Total for one unit. Use 0 to reset it, or a reading from a meter you kept previously to carry that figure over. Only affects the integration's own total - the unit's counter cannot be written.Fields: Value

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Changes its own settings when asked for operation data

From the README

This is a Home Assistant integration for Mitsubishi Heavy Industries air conditioners that use the WF-RAC WiFi module and the "Smart M-Air" app.
Not compatible with Mitsubishi Electric systems (e.g. those using a MAC-577IF2-E interface) or the MELCloud platform — those are a different manufacturer with a different app and protocol. If your unit uses MELCloud, see Home Assistant's built-in MELCloud integration instead.

From the README of blues-sechseck/Mitsubishi-WF-RAC-Integration, MIT License. Shortened.