Matter Hub

Matter Hub es un addon que permite exponer los dispositivos de Home Assistant hacia controladores Matter externos como Alexa, Google Home o Apple HomeKit. A diferencia de soluciones que pasan por la nube, Matter Hub funciona 100% en local mediante el protocolo Matter.

Caution

Matter Hub no es estable. Sin plugins adicionales, no soporta todos los tipos de dispositivos. También puede dar errores por lo que se dupliquen o no se identifiquen correctamente. Para una solución más establecida, usa Matterbridge.

Note

El proyecto original t0bst4r/home-assistant-matter-hub fue deprecado en enero 2026. El fork activo y mantenenido es RiDDiX/home-assistant-matter-hub, que es el que se documenta aquí.

Tip

Matter Hub es una alternativa a Matterbridge. Ambos cumplen la misma función (exponer dispositivos de HA hacia Alexa/Google/Apple) pero con diferentes implementaciones. También es distinto de Matter Server, que permite añadir dispositivos Matter externos a Home Assistant.

Warning

Matter requiere que IPv6 esté activado en la red local. Los controladores Matter (Echo, Google Nest, etc.) usan IPv6 para descobrir y comunicarse con el bridge. Si IPv6 está bloqueado o desactivado, el emparejamiento fallará.

Instalación (Addon de HA)

  1. Ir a Ajustes → Complementos → Tienda de complementos
  2. Añadir el repositorio: https://github.com/RiDDiX/home-assistant-addons
  3. Buscar Home-Assistant-Matter-Hub e instalarlo
  4. Activar Inicio automático y Vigilancia
  5. Iniciar el addon
Note

También hay disponible Home-Assistant-Matter-Hub (Alpha) para probar versiones en desarrollo.

Configuración

Abrir la interfaz web de Matter Hub desde el painel lateral y configurar:

Crear un Bridge

  1. Hacer clic en + New Bridge
  2. Asignar un nombre (ej. Mi Casa)
  3. Guardar

Filtros de entidades

En cada bridge se puede configurar qué entidades exportar:

Server Mode (opcional)

Para robot vacuums, activar Server Mode al crear el bridge. Esto expone el dispositivo como Matter standalone en lugar de bridge, necesario porque Alexa y Apple Home no soportan robot vacuums bridged.

Vincular con controladores

Alexa

  1. Abrir la app de Alexa
  2. Ir a Dispositivos → Añadir dispositivo → Otro → Matter
  3. Seleccionar "Conectar mediante código"
  4. Introducir el código del bridge (disponible en la interfaz de Matter Hub)
Note

Por defecto Matter Hub usa el primer puerto disponible. Si da error, prueba cambiando el puerto en la configuración del addon.

Google Home

  1. Abrir la app de Google Home
  2. Pulsar + → Configurar dispositivo → Dispositivo nuevo
  3. Escanear el código QR del bridge

Apple HomeKit

  1. En Matter Hub, obtener el código QR del bridge
  2. Abrir la app Casa en iPhone/iPad
  3. Pulsar + → Añadir accesorio
  4. Escanear el código QR

Dispositivos compatibles

Matter Hub puede exponer los siguientes tipos de entidades:

Tipo HATipo MatterNotas
lightOnOffLight, DimmableLight, ColorTemperatureLight, ExtendedColorLightCompatible con регулировка brillo y temperatura de color
switchOnOffPlugInUnit
lockDoorLock
fanOnOffPlugInUnit
climateThermostat
vacuumRobot VacuumRequiere Server Mode
sensorTemperature, Humidity, Power, etc.Solo algunos tipos
Warning

Los pulsadores (entidades button o event) no son compatibles con Matter. Los pulsadores únicamente disparan acciones pero no tienen estado, y Matter requiere dispositivos con estado (encendido/apagado, porcentaje, temperatura, etc.).

resolución de problemas

ProblemaCausaSolución
El controlador no descubre el bridge IPv6 desactivado Activar IPv6 en el router
Error "port already in use" Otro servicio usando el puerto 5540 Cerrar otro addon Matter o usar otro puerto (solo Alexa requiere 5540)
Dispositivo no aparece en Alexa No tiene la etiqueta correcta Añadir la etiqueta configurada en el filtro del bridge
Robot vacuum no responde No usa Server Mode Crear un bridge específico con Server Mode activado

Ver también: Matter Server, Añadir segunda plataforma de voz