Community Fork - This is a fork of the original t0bst4r
/home -assistant -matter -hub, which was discontinued in January 2026. We continue active development with bug fixes, new features, and community support. We actively work on fixing old issues from the original project and welcome new feature requests. This is a living project maintained by the community!
This project simulates bridges to publish your entities from Home Assistant to any Matter-compatible controller like Alexa, Apple Home or Google Home. Using Matter, those can be connected easily using local communication without the need of port forwarding etc.
Known issues and limitations¶
Device Type Support¶
This project does not yet support all available device types in the matter specification. In addition, controllers like Alexa or Google Home do not support all device types, too.
To check which types are supported, please review the list of supported device types.
Alexa¶
Alexa cannot pair with a bridge which has too many devices attached. It seems to have a limit of about 80-100 devices
Alexa needs at least one Amazon device which supports Matter to pair with a Matter device. If you only have a third party smart speaker which supports Alexa, this isn’t enough.
Google Home¶
Google Home needs an actual Google Hub to connect a Matter device. Just using the GH app isn’t enough.
Google Home can deny the Matter device under certain conditions because it is not a certified Matter device. You need to follow this guide to register your hub.
Network setup¶
The Matter protocol is designed to work best with UDP and IPv6 within your local network. At the moment some manufacturers built their controllers to be compatible with IPv4, too, but this can break at any time with any update.
Many users report connection issues when using VLANs or firewalls, where HAMH and the assistant devices (Alexa, Google Home, ...) are not placed in the same network segment. Please make sure to review the common connectivity issues.
What’s New¶
📦 Stable (v2.0.17) - Current
| Feature | Description |
|---|---|
| 🏷️ Room Label (FixedLabel) | HA area names sent to controllers via Matter FixedLabel cluster. No major controller currently reads this for automatic room assignment — rooms must be assigned manually. (#77) |
| �️ Thermostat Overhaul | Feature variants (heat-only, cool-only, full HVAC), negative temp support, hvac_action-based running state, NaN guards (#146) |
| 🔒 Lock Unlatch/Unbolt | Apple Home Unlatch button for locks with HA OPEN support (#153) |
| 🌡️ Auto Pressure Mapping | Pressure sensors auto-combined with temperature sensors (e.g. Aqara WSDCGQ11LM) |
| � Binary Sensor Fix | running/plug/power now map to OnOffSensor instead of ContactSensor (#154) |
| 🤖 Vacuum Fixes | Apple Home “Updating” fix, GoHome command, OperationCompletion event (#103) |
| 🔌 Dead Session Recovery | Auto force-close dead Alexa sessions (#105) |
| � Water Heater Limits | Correct min/max from HA entity (#145) |
| � Cover Fix | coverSwapOpenClose position display fix (#148) |
| �️ Fan Oscillation Fix | Proper rockSupport/windSupport defaults |
| � Mobile UI | Responsive navigation with hamburger menu (#144) |
| 🗺️ Network Map | React Flow visualization of bridge topology |
| 🧠 Memory Limit | 512MB heap limit for low-resource devices (#141) |
| �️ Crash Resilience | Per-property error handling, behavior error logging |
🧪 Alpha (v2.1.0-alpha.x)
| Feature | Description |
|---|---|
| 🔗 Auto Composed Devices | Master toggle (autoComposedDevices) that creates real Matter Composed Devices for temperature sensors with related humidity/pressure/battery entities. Uses BridgedNodeEndpoint with separate sub-endpoints per sensor type so Apple Home and Alexa properly display each reading. Also enables power/energy auto-mapping for switches. See Alpha Features Guide. |
| 📊 Live Diagnostics | Real-time event streaming in the Health Dashboard. Bridge lifecycle events, color-coded event types with filtering. WebSocket-based with subscribe/unsubscribe protocol. |
| 🔧 DoorLock Fix | Corrected supportedOperatingModes inverted bitmap semantics per Matter spec |
| ⚡ Energy Event | ElectricalEnergyMeasurement now emits cumulativeEnergyMeasured event per matter.js reference |
| 🤖 Automation Fix | turnOff now sends automation.turn_off (disable) instead of no-op |
| 🏠 Dashboard | New landing page with bridge overview, quick navigation, and Bridge Wizard access |
| 🔍 Entity Autocomplete | Search-as-you-type entity suggestions in Entity Mapping dialogs |
| ⏱️ Light Transitions | Matter transition times forwarded to HA light.turn_on service |
| 🌡️ Thermostat Auto-Resume | Auto-resume works even when setting same temperature while off (#176) |
| 🤖 Vacuum Docked State | Vacuums correctly show “Docked” instead of “Paused” when charging (#165) |
| 📱 Dashboard UI | Responsive cards, sorted bridges, icon legend, mobile-optimized |
| 💾 Memory Fixes | Endpoint disposal fixes to prevent OOM issues |
| 🔋 Reduced Logging | Battery sensor mapping no longer spams logs |
📜 Previous Versions
v2.0.16¶
Force Sync, Lock PIN, Cover/Blinds improvements, Roborock Rooms, Auto Entity Grouping, Water Heater, Vacuum Server Mode, OOM fix
v1.9.0¶
Custom bridge icons, Basic Video Player, Alexa deduplication, Health Check API, WebSocket, Full backup/restore
v1.8.x¶
Graceful crash handler, PM2.5/PM10 sensors, Water Valve, Smoke/CO Detector, Pressure/Flow sensors
v1.5.x¶
Health Monitoring, Bridge Wizard, AirQuality sensors, Fan control, Media playback
Getting started¶
To get things up and running, please follow the installation guide.
Additional Resources¶
If you need more assistance on the topic, please have a look at the following external resources:
Videos¶
YouTube-Video on “HA Matter HUB/BRIDGE 😲 👉 Das ändert alles für ALEXA und GOOGLE Nutzer” (🇩🇪)¶
YouTube-Video on “Alexa et Google Home dans Home Assistant GRATUITEMENT grâce à Matter” (🇫🇷)¶
Support the Project¶
This is completely optional! The project will continue regardless of donations. I maintain this in my free time because I believe in open source and helping the community.
If you find this project useful and want to support its development, consider buying me a coffee! ☕
Maintaining this project takes time and effort - from fixing bugs, adding new features, to helping users in issues. Your support is appreciated but never expected. Thank you for using Home-Assistant-Matter-Hub! ❤️