Homebridge MELCloud Home

Homebridge plugin for Mitsubishi Electric Air Conditioners using the MELCloud Home platform (melcloudhome.com).

Background

I needed a way to control my Mitsubishi AC units through HomeKit, but the existing MELCloud plugins only worked with the old MELCloud platform (app.melcloud.com). My units use the newer MELCloud Home platform (melcloudhome.com), which has a completely different API.

So I created this plugin with the help of Claude Code.

Support This Project

☕ Buy Me a Coffee

Credits

Thanks to homebridge-melcloud-control for inspiration on the Homebridge integration patterns.

Features

• Power on/off
• Temperature control (including 0.5° increments)
• Mode switching (Heat, Cool, Auto)
• Fan speed control (Auto + 5 speed levels)
• Real-time temperature monitoring
• Automatic device discovery
• Long-lived sessions - authenticate once, automatic token refresh keeps you connected
• Lightweight & always responsive - no browser dependencies or periodic re-authentication delays
• Homebridge v1 & v2 compatible

Important: MELCloud vs MELCloud Home

This plugin is only for MELCloud Home (melcloudhome.com). If you use the original MELCloud (app.melcloud.com), you need a different plugin like homebridge-melcloud-control.

Not sure which one you have? Check which website you log into - if it's melcloudhome.com, you're in the right place.

Installation

Via Homebridge UI

1. Search for homebridge-melcloud-home in the Homebridge plugins tab
2. Click Install
3. Click Settings (gear icon) after installation
4. Enter your MELCloud email and password in Step 1
5. Click "Login and Get Token" - your token will be obtained automatically
6. Click "Save Token" in Step 2
7. Restart Homebridge

Via npm

npm install -g homebridge-melcloud-home

Setup

1. Install the plugin via Homebridge UI
2. Click the Settings button (⚙️)
3. Step 1: Enter your MELCloud email and password, then click "Login and Get Token"
4. Step 2: Your token will appear automatically - click "Save Token"
5. Step 3: Configure settings (refresh interval, debug mode, etc.) - they save automatically
6. Restart Homebridge

Your devices will appear in HomeKit automatically!

Authentication

The plugin uses OAuth for secure authentication:

• Your credentials are sent directly to MELCloud's servers (never stored by the plugin)
• A refresh token is saved in your Homebridge config
• The token is automatically refreshed when needed (no re-authentication required)
• Works in all browsers (Safari, Chrome, Firefox, Edge)

Configuration

All settings can be configured through the custom UI - click the Settings (⚙️) button on the plugin.

| Setting | Description | Default | |---------|-------------|---------| | refreshInterval | How often to check device status (seconds). With 30-second polling, changes from the MELCloud app or remote control are picked up quickly. Configurable from 10-3600 seconds. | 30 | | debug | Enable detailed logging for troubleshooting. Shows all refresh data, API calls, and state changes without requiring Homebridge debug mode. | false | | exposeTemperatureSensor | Add a separate temperature sensor for each AC unit that can be used in HomeKit automations. | true |

Changelog

See CHANGELOG.md for full version history.

License

Apache-2.0

Issues & Contributions

Found a bug? Have an idea? Open an issue on GitHub.