Midea Air
homebridge-midea-air · v1.7.3
Controls Midea-platform air conditioners and dehumidifiers, including many rebranded units, through the MSmart cloud.
What it says it supports
Brands
- Midea
- Carrier
- Toshiba
- LG
- Samsung
- Senville
- Comfee
- Electrolux
- Pioneer
- Lennox
- Trane
Devices it names
- OSK102 dongle
- OSK103 dongle
- Midea air conditioners
- Midea dehumidifiers
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Works with Midea ACs using OSK102/OSK103 dongles; U-model OSK103, OSK105 and Tuya dongles are read-only or unsupported.
- Works1
- Partly works5
- Requested1
- Won’t be supported1
| Device | Status | What they said | Source |
|---|---|---|---|
| Midea AC with OSK102/OSK103 dongle | Works | Maintainer says OSK102 and OSK103 are supported; some unique OSK103 are notSaved copyHi, We tried this morning with the Huubs Support to fix a Problem with the Midea Air Plugin, but failed. Maybe you can help: Logfile say: 19/08/2023, 09:40:43Midea Air BridgeConfiguration change 19/08/2023, 09:41:01Midea Air BridgeLoaded plugin 'homebridge-midea-air' 19/08/2023, 09:41:01Midea Air BridgeLoading 1 platforms... 19/08/2023, 09:41:01Midea Air Bridgemidea-airLoading accessory from cache: Guest bedroom 19/08/2023, 09:41:02Midea Air BridgeBridge is running on port 51846. 19/08/2023, 09:41:06Midea Air Bridgemidea-airCreated device: Guest bedroom, with ID: 147334558255807, and type: … Excerpt saved from GitHub on 2026-10-22. | Issue #124 · 2023-08 |
| Carrier 42QHG009D8S split with OSK103 dongle | Partly works | Reads state only; commands rejectedSaved copyI have 2 différents indoors units : Split Carrier model 42QHG012D8S (x1) and Split Carrier model 42QHG009D8S (x2). Units outdoor are 38QHG009D8S (x2) and 38QHG012D8S. Thank you :) Le 5 oct. 2021 à 18:00, Yossi Hillali *@*.*> a écrit : Send me your AC model, You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. Excerpt saved from GitHub on 2026-10-22. | Issue #26 · 2021-10 |
| Carrier 42QHG012D8S split with OSK103 dongle | Partly works | Temperature reads but commands not accepted; U-model dongle only reads stateSaved copyI have 2 différents indoors units : Split Carrier model 42QHG012D8S (x1) and Split Carrier model 42QHG009D8S (x2). Units outdoor are 38QHG009D8S (x2) and 38QHG012D8S. Thank you :) Le 5 oct. 2021 à 18:00, Yossi Hillali *@*.*> a écrit : Send me your AC model, You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. Excerpt saved from GitHub on 2026-10-22. | Issue #26 · 2021-10 |
| Midea msmabu-12hrdn8 with SK103 dongle | Partly works | State visible, cannot control; U-model not fully supportedSaved copyHey there, thanks for the superfast reply! :) The Midea device type is "msmabu-12hrdn8". Can I use it with another dongle which is compatible with Homebridge? Thanks for the reply! Best, David Excerpt saved from GitHub on 2026-10-22. | Issue #44 · 2022-01 |
| Midea U-Shape window AC | Partly works | One user has it working but only cooling on/off and temperature, no swing or ecoSaved copyI have this working, but the integration kind of sucks. It only lets you enable/disable cooling and set the temp. As opposed to cooling type, eco mode, swing (even though there is a button for it). I have had better luck manipulating their api via a python library, and that gives much more control. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-05 |
| Senville SENA-36HF-T tri-zone mini split | Partly works | Works but tile temperature stayed fixed on multi-head unitSaved copyit is this unit: https://senville.ca/36000-btu-tri-zone-mini-split-air-conditioner-sena-36hf-t/ Excerpt saved from GitHub on 2026-10-22. | Issue #36 · 2021-12 |
| Midea Mission II / Blanc OSK105 | Requested | Command protocol differs; support requested, issue openSaved copy[4/9/2021, 10:11:58 PM] [midea-air] Login successful [4/9/2021, 10:11:58 PM] [midea-air] getUserList called [4/9/2021, 10:12:04 PM] [midea-air] Adding new device: Office [4/9/2021, 10:12:04 PM] [midea-air] created device Office with id 18691697846256 and type 172 [4/9/2021, 10:12:04 PM] [midea-air] Device type is 172 [4/9/2021, 10:12:04 PM] [midea-air] Adding new device: Master bedroom [4/9/2021, 10:12:04 PM] [midea-air] created device Master bedroom with id 16492674450993 and type 172 [4/9/2021, 10:12:04 PM] [midea-air] Device type is 172 [4/9/2021, 10:12:04 PM] [midea-air] Adding new … Excerpt saved from GitHub on 2026-10-22. | Issue #3 · 2021-04 |
| Inventor AC with Tuya EU-ODZ104 dongle | Won’t be supported | Maintainer says Tuya dongles are not supportedSaved copyYour dongle is Tuya EU-ODZ104. Do you use Midea app or Tuya app? This plugin don't support Tuya dongles. Excerpt saved from GitHub on 2026-10-22. | Issue #50 · 2022-02 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud
Midea MSmart cloud API via account
You’ll need
- Midea/MSmart account
- OSK102 or OSK103 dongle
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | >=1.5.0 |
| Homebridge 2.0 | No |
| Node.js | >=16.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | midea-air |
| License | MIT |
Community signals
| Downloads a week | 86 |
|---|---|
| Downloads a month | 175 |
| GitHub stars | 73 |
| Open issues | 17 |
| Closed issues | 109 |
| Last code push | 2023-01-28 |
| Latest version | 1.7.3 (2022-11-26) |
| First published | 2021-03-25 |
| Releases | 81 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- This plugin is archived, deprecated or on Homebridge’s unmaintained list.
- Many devices unsupported or partially working due to undocumented API
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Fanv2
- HeaterCooler
- HumidifierDehumidifier
- TemperatureSensor





