nuki-mcp

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

📖 Installation Guide — quick start, manual setup, and troubleshooting

FastMCP 3.2 server for Nuki Smart Lock control via Home Assistant Bridge.

Built for Stroheckgasse, Vienna — buzz the main door, unlock the apartment, check battery levels, all through Home Assistant.

Features

• get_lock_status — state, battery, friendly name
• set_lock_state — lock/unlock
• buzz_opener — electric strike for intercom entry
• smart_entry_sequence — multi-step: buzz main door → wait → unlock apartment
• nuki_security_dashboard — MCP prompt for security monitoring

Quick start

git clone https://github.com/sandraschi/nuki-mcp.git
cd nuki-mcp
just install

Configure .env:

HASS_URL=http://homeassistant.local:8123
HASS_TOKEN=your_long_lived_token

just install-mcp claude

Tools

Tool	What it does
get_lock_status	Check lock state, battery, attributes
set_lock_state	Lock or unlock a Nuki device
buzz_opener	Trigger intercom electric strike
smart_entry_sequence	Buzz main door → wait → unlock apartment

Just recipes

just lock       # Quick lock test
just unlock     # Quick unlock test
just buzz       # Buzz intercom
just lock-status # Check lock state + battery