ha-mcp-server

ha-mcp-server

0
os_automation

Home Assistant MCP Server is a Model Context Protocol Server designed to provide SSE-based tools for inspecting and optimizing automations, scripts, scenes, and helpers in Home Assistant. It offers features such as API-Key authentication and optimization recommendations.

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