Home Assistant integration for Motorline MCONNECT — control your gates, lights, shutters, locks and more directly from Home Assistant.
- Real-time updates via MQTT push — instant state changes without polling delays
- Automatic device discovery — new devices and scenes added in MCONNECT appear automatically in HA
- OAuth authentication — secure login via the MCONNECT webapp (email, Google, Facebook or Apple)
- Personal Access Tokens — revocable tokens managed from your MCONNECT account
- Automatic token refresh — access tokens renew seamlessly without user intervention
- Full diagnostics — downloadable diagnostics with sensitive data redacted
| MCONNECT type | HA platform | Features |
|---|---|---|
| Gate / Garage / Link | Cover | Open, Close, Stop, Position |
| Shutter / Window / Door | Cover | Open, Close, Stop |
| Light | Light | On/Off, Brightness |
| Dimmer | Light | On/Off, Brightness |
| Switch / Plug / RF Controller | Switch | On/Off |
| Lock | Lock | Lock/Unlock |
| Fan | Fan | On/Off, Speed |
| Thermostat | Climate | On/Off, Temperature, Modes |
| Sensor | Sensor | Temperature, Humidity, Power, Energy, etc. |
| Motion Sensor / ZB Motion Sensor | Binary sensor | Motion detection |
| Scenes | Scene | Activate |
- Open HACS in your Home Assistant
- Click ⋮ → Custom repositories
- Add
https://github.com/Motorline/ha-mconnectwith category Integration - Search for Motorline MCONNECT and click Download
- Restart Home Assistant
- Download the latest release
- Extract the
mconnectfolder intoconfig/custom_components/ - Restart Home Assistant
- Go to Settings → Devices & Services → Add Integration
- Search for MCONNECT
- A browser window opens to the MCONNECT login page
- Sign in with your MCONNECT account and select your home
- The window closes automatically and your devices appear in HA
No manual configuration or YAML is needed.
The integration connects to the Motorline MCONNECT cloud platform:
- REST API — fetches devices, scenes and states every hour as a sync fallback
- MQTT — receives real-time push updates for instant state changes
- OAuth — authenticates via server-signed JWTs with automatic token refresh
When you change a device state in the MCONNECT app, it appears in HA within seconds via MQTT. The 60-second polling serves as a fallback to ensure data stays in sync.
If your session expires or is revoked, Home Assistant will show a notification asking you to re-authenticate. Click it and sign in again — all your devices and automations remain intact.
You can also manage your Home Assistant personal access token from the MCONNECT app/webapp under account settings.
- Go to Settings → Devices & Services
- Find MCONNECT and click ⋮ → Delete
- All devices and entities will be removed from HA
This does not affect your MCONNECT account or devices.
| Issue | Solution |
|---|---|
| "Authentication failed" during setup | Ensure you're using the correct MCONNECT account and that your subscription is active |
| Setup fails on mobile app | Go to Settings → System → Network and set your external Home Assistant URL |
| Devices show as "Unavailable" | Check that the MCONNECT endpoint/hub is online in the MCONNECT app |
| MQTT disconnects in logs | Normal when access token refreshes — the connection recovers automatically within seconds |
| Scenes not appearing | New scenes are detected via MQTT push or on the hourly sync — restart the integration to force an immediate refresh |
| Re-auth notification keeps appearing | Remove the integration and add it again to get a fresh token |
- Requires an active MCONNECT cloud account and internet connection (cloud-based integration)
- Cover position feedback depends on the physical device supporting it — most Motorline gates are open/close only
- Device names and icons come from the MCONNECT platform — rename them in HA via the entity settings if needed
This project is licensed under the MIT License with Commons Clause — you are free to use, modify, and contribute, but commercial use by third parties is not permitted. See LICENSE for details.