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