Home Assistant MCP Server

Model Context Protocol (MCP) Server for Home Assistant
Provides SSE‑based tools to inspect and optimize your automations, scripts, scenes, and helpers.

Features

- SSE transport with API‑Key authentication
- Tools: get_automations, get_scripts, get_scenes, get_helpers
- Optimization via recommend_optimizations

Setup

1. Clone and cd into this repo
2. Copy .env.example → .env and fill in values
3. npm install
4. npm run build
5. npm start

Server runs at http://localhost:${PORT}/sse (default 8080).
Use X-API-Key header to authenticate.

Tools

- get_automations → list all automations
- get_scripts → list all scripts
- get_scenes → list all scenes
- get_helpers → list all helpers
- recommend_optimizations → simple recommendations based on fetched data

MIT License