Home-Assistant-Matter-Hub
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.36) - Current
New in v2.0.36:
| Feature | Description |
|---|---|
| 🏗️ User-Defined Composed Devices | Create custom composed devices via composedEntities mapping (#220) |
| 🔌 Plugin Domain Mappings | Domain mapping support in plugin API with cloud-mock example |
| 🔋 Valve & Pump Battery | Battery support for valve and pump endpoints |
| 🌐 German + Russian Translations | Complete German translation and new Russian language |
| 📡 Session Recovery | Graceful session close, dead session cleanup, mDNS re-announcement (#266) |
| 🔗 Quick Link to Failed Devices | Dashboard quick link to failed devices (#270) |
| 🌡️ Thermostat Fix | Skip climate.turn_on when already on (#269) |
| 🪟 Cover Fix | Correct stale targetPosition during external movement (#268) |
| 🌬️ Air Purifier Fix | Sub-endpoints for composed air purifier, manual temp/humidity mapping (#265) |
| 🔥 Cooling-Only Thermostat Fix | Prevent HeatingOnly on cooling-only thermostat (#264) |
| ↔️ Per-Entity Cover Swap | Individual coverSwapOpenClose per cover (#263) |
Previously in v2.0.35:
| Feature | Description |
|---|---|
| 🏠 HA 2026.3 Clean Area Support | Native support for the new vacuum.clean_area action |
| 🤖 Valetudo Identifier Mapping | Custom valetudoIdentifier for MQTT topic case mismatches |
| 🔌 Plugin System Hardening | Validation, API version check, tgz upload/local install |
| 📖 Docusaurus Docs | New documentation site with improved search and navigation |
🧪 Alpha (v2.1.0-alpha.x)
Alpha is currently in sync with Stable (v2.0.36). All alpha features have been promoted to stable. New alpha features will appear here as development continues. See the Alpha Features Guide for installation instructions.
📋 Previous Versions
v2.0.29
Light currentLevel Fix, Bridge Config Save Fix, Fan Device Feature Fix, Humidity Auto-Mapping Fix
v2.0.28
Device Image Support, Custom Fan Speed Mapping, TV Source Selection, Reverse Proxy Base Path, On/Off-Only Fans, Light Brightness Fix, Fan Speed Fixes, Composed Air Purifier Fix, Dreame Multi-Floor Fix, Optimistic State Updates, Frontend Improvements
v2.0.27
Valetudo support, Custom Service Areas, ServiceArea Maps, Vacuum Identify/Locate/Charging, Alarm Control Panel, Composed Air Purifier, Dashboard Controls, Vendor Brand Icons, Thermostat fixes
v2.0.26
Authentication UI, Select Entity Support, Webhook Event Bridge, Cluster Diagnostics, Matter.js 0.16.10, Docker Node 22
v2.0.25
Vacuum mop intensity, vacuum auto-detection, Roborock room auto-detect, live entity mapping, dynamic heap sizing
v2.0.17–v2.0.23
Thermostat overhaul, Lock Unlatch, Vacuum Server Mode, Bridge Templates, Live Filter Preview, Entity Diagnostics, Multi-Bridge Bulk Operations, Power & Energy Measurement, Event domain, Network Map, Mobile UI
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! ❤️