Nuki Smart Lock


The nuki platform allows you to control Nuki Smart Locks via either a software bridge or a physical bridge.

To add a Nuki bridge to your installation, you need to enable developer mode on your bridge and define a port and an access token. This can be achieved using the Android app. Please note that the API token should be 6-20 characters long, even though the app allows you to set a longer one. Then add the following to your configuration.yaml file:

# Example configuration.yaml entry
lock:
  - platform: nuki
    host: 192.168.1.120
    token: fe2345ef

Configuration variables:

  • host (Required): The IP or hostname of the Nuki bridge.
  • port (Optional): The port on which the Nuki bridge is listening on. Defaults to 8080.
  • token (Required): The token that was defined when setting up the bridge.

Full configuration

Here’s a full configuration example for a Nuki bridge:

# Example configuration.yaml entry
lock:
  - platform: nuki
    host: 192.168.1.120
    port: 8080
    token: fe2345ef

Services

Service nuki_unlatch

This will unlatch the door, ie. open it (provided this works with your type of door).

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_ids Nuki Locks.

Service nuki_lock_n_go

This will first unlock, wait a few seconds (20 by default) then re-lock. The wait period can be customized through the app. See the Nuki Website for more details about this feature.

Service data attribute Optional Description
entity_id yes String or list of strings that point at entity_ids Nuki Locks.
unlatch yes Boolean - Whether to unlatch the door when first opening it.