Nuki Smart Lock Pro 5 con Home Assistant vía Matter

Publicado el 20-10-2026

La Nuki Smart Lock Pro 5.ª gen. se integra en Home Assistant por Matter sobre Thread, en local y sin Nuki Bridge ^[1]: se activa Matter en la app Nuki y se escanea su código QR desde la integración Matter de Home Assistant; el alta tarda entre 30 y 90 segundos. Hace falta un border router Thread en la red ^[4]. Quedan una entidad lock y un sensor de batería ^[1]^[3].

Antes de empezar: necesitas el Nuki Smart Lock Pro 5.ª gen. instalado en la puerta y Home Assistant funcionando en tu red. Los pasos siguen la integración vía Matter sobre Thread, que es la opción local sin necesidad del Nuki Bridge. Al final encontrarás la alternativa con Bridge para quien prefiera ese camino.

Requisitos previos

Antes de empezar, comprueba que tienes:

Nuki Smart Lock Pro 5.ª gen. — es el único modelo Nuki con Matter sobre Thread integrado ^[1].
Home Assistant con supervisor activo — imprescindible para la integración Matter. Home Assistant OS y Home Assistant Supervised la incluyen por defecto ^[3].
Border router Thread en la red — el Home Assistant Connect ZBT-2 puede funcionar en modo Thread (OpenThread Border Router) ^[4]. Si ya tienes otro border router Thread activo en la red (Apple TV 4K, HomePod mini, Google Nest Hub 2.ª gen.), también vale.
App Nuki — versión actual en el móvil, con la cerradura ya configurada y funcionando.

El Nuki Bridge no es necesario si usas Matter: la cerradura se integra en HA directamente por Thread, sin pasar por los servidores de Nuki ^[1].

Activar Matter en la app Nuki

Abre la app Nuki y entra en los ajustes de la cerradura (icono de engranaje junto al nombre).
Ve a Integración con plataformas inteligentes → Matter.
Pulsa Añadir dispositivo Matter y espera a que la app genere el código QR de emparejamiento.
No cierres esta pantalla: la usarás en el paso siguiente desde Home Assistant ^[1].

Añadir a Home Assistant como dispositivo Matter

En Home Assistant, ve a Ajustes → Dispositivos e integraciones → Añadir integración y busca Matter.
Selecciona Añadir dispositivo Matter → Escanear código QR.
Apunta la cámara del móvil al QR que muestra la app Nuki (o introduce el código manualmente si la cámara no funciona).
HA descubre la cerradura y la añade a la integración Matter. El proceso tarda entre 30 y 90 segundos.
Asigna la cerradura a una habitación (por ejemplo, «Entrada») para que aparezca en el panel de HA ^[3].

Si el emparejamiento falla, comprueba que el border router Thread está activo y que el ZBT-2 (si lo usas) tiene cargado el firmware de OpenThread Border Router y no el de Zigbee.

Entidades disponibles tras la integración

Una vez añadida la cerradura Matter, HA crea estas entidades:

Entidad	Tipo	Descripción
`lock.<nombre>`	Lock	Estado (bloqueado / desbloqueado) y acción de bloquear/desbloquear ^[3]
`sensor.<nombre>_battery`	Sensor	Nivel de batería en porcentaje ^[1]

La entidad lock es la que usarás en automatizaciones. Puedes bloquear y desbloquear desde el panel de HA, desde la app móvil y por automatización.

Nuki no expone el historial de aperturas individuales por personas a través de Matter; ese registro queda en la app Nuki. Si necesitas eventos detallados por usuario, la alternativa del Bridge (sección siguiente) ofrece mayor visibilidad ^[2].

Automatización: bloquear la cerradura cuando el último teléfono sale de casa

Esta automatización bloquea la cerradura cuando nadie del hogar está en la zona «Home». Requiere tener la Companion App de Home Assistant instalada en los móviles de las personas del hogar.

alias: Bloquear al salir — último teléfono fuera de casa
trigger:
  - platform: state
    entity_id: zone.home
    attribute: persons
    to: "0"
condition: []
action:
  - service: lock.lock
    target:
      entity_id: lock.nuki_entrada
mode: single

Si prefieres basarte en la entidad person en lugar del conteo de la zona:

alias: Bloquear al salir — todos fuera de casa
trigger:
  - platform: state
    entity_id:
      - person.toni
      - person.anna
    to: "not_home"
condition:
  - condition: state
    entity_id: person.toni
    state: not_home
  - condition: state
    entity_id: person.anna
    state: not_home
action:
  - service: lock.lock
    target:
      entity_id: lock.nuki_entrada
mode: single

Sustituye lock.nuki_entrada, person.toni y person.anna por los entity_id reales de tu instalación. Añade tantas personas como tenga el hogar en las condiciones.

Alternativa sin Matter: integración Nuki vía Bridge

Si no tienes un border router Thread o prefieres una integración más detallada, el Nuki Bridge expone una API HTTP local que Home Assistant usa directamente ^[2].

Pasos con Bridge

Instala el Bridge en un enchufe a menos de 5 m de la cerradura.
Empareja el Bridge con la cerradura desde la app Nuki (Ajustes → Bridge).
En HA, ve a Ajustes → Dispositivos e integraciones → Añadir integración y busca Nuki.
Introduce la IP local del Bridge y el token de acceso (se genera desde la app Nuki → ajustes del Bridge → API).
HA descubre la cerradura y el Bridge como dispositivos ^[4].

La integración vía Bridge ofrece acceso al historial de aperturas por código, NFC o usuario de la app, además de las entidades de lock y batería. No requiere Thread ni border router. Su punto débil es que el Bridge necesita Bluetooth activo y mantenerse a menos de 5 m de la cerradura.

Cuándo necesitas el Bridge y cuándo no

Escenario	¿Necesitas Bridge?
Integración Matter sobre Thread	No — la Pro 5 conecta directamente por Thread ^[1]
Acceso remoto desde fuera de casa con la app Nuki	No — la Pro 5 tiene Wi-Fi integrado ^[1]
Integración local con HA vía API HTTP (Nuki integration)	Sí — el Bridge es el intermediario ^[2]
Historial de aperturas por usuario en HA	Sí — solo disponible vía Bridge ^[2]
Cerradura Nuki de generaciones 1.ª a 4.ª	Sí — sin Matter, la API del Bridge es la única vía local ^[2]

Preguntas frecuentes

¿Puedo usar Matter y el Bridge a la vez?

Sí. Matter gestiona el estado de la cerradura en HA con baja latencia; el Bridge añade el historial de eventos. Puedes tener ambas integraciones activas simultáneamente en el mismo Home Assistant.

¿La integración Matter funciona si cae internet?

Sí. Matter opera en la red local: HA y la cerradura se comunican por Thread sin salir a internet. El acceso remoto a HA (si lo tienes configurado) requiere conexión, pero las automatizaciones locales siguen funcionando sin internet ^[3].

¿El ZBT-2 puede hacer de border router Thread y de coordinador Zigbee a la vez?

No: el ZBT-2 funciona en un solo modo a la vez, o Zigbee o Thread. Si necesitas ambos, conecta dos adaptadores al mismo equipo ^[4].

¿Qué pasa si la batería de la cerradura se agota?

La llave física sigue funcionando siempre. HA muestra el nivel de batería en el sensor correspondiente y puedes crear un aviso cuando baje del umbral que configures ^[1].

Fuentes

Nuki, Smart Lock Pro — https://nuki.io/en/products/smart-lock-pro/ (2026-10-01)
Nuki, Bridge — https://nuki.io/en/products/bridge (2026-09-30)
Home Assistant, integración Matter — https://www.home-assistant.io/integrations/matter/ (2026-10-01)
Home Assistant, integración Nuki — https://www.home-assistant.io/integrations/nuki/ (2026-10-01)

Este artículo se ha elaborado con inteligencia artificial y puede contener errores. Si ves alguno, escríbenos a info@comfortek.es y lo corregimos.