# 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](INSTALL.md)** — 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

```powershell
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
```

```powershell
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
```