Skip to content
Homebridge TestFlight
Midea, Carrier, Toshiba

Midea Air

homebridge-midea-air · v1.7.3

CloudArchived

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
DeviceStatusWhat they saidSource
Midea AC with OSK102/OSK103 dongleWorksMaintainer says OSK102 and OSK103 are supported; some unique OSK103 are not
Saved copy
Hi, 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 donglePartly worksReads state only; commands rejected
Saved copy
I 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 donglePartly worksTemperature reads but commands not accepted; U-model dongle only reads state
Saved copy
I 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 donglePartly worksState visible, cannot control; U-model not fully supported
Saved copy
Hey 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 ACPartly worksOne user has it working but only cooling on/off and temperature, no swing or eco
Saved copy
I 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 splitPartly worksWorks but tile temperature stayed fixed on multi-head unit
Saved copy
it 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 OSK105RequestedCommand protocol differs; support requested, issue open
Saved 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 dongleWon’t be supportedMaintainer says Tuya dongles are not supported
Saved copy
Your 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 HomebridgeNo
Homebridge versions>=1.5.0
Homebridge 2.0No
Node.js>=16.0.0
Settings in Homebridge UIYes
MatterNo
Platform namemidea-air
LicenseMIT

Community signals

Downloads a week86
Downloads a month175
GitHub stars73
Open issues17
Closed issues109
Last code push2023-01-28
Latest version1.7.3 (2022-11-26)
First published2021-03-25
Releases81

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