Overview
What is Home Assistant MCP Server?
Home Assistant MCP Server is an SSE‑based Model Context Protocol server that provides tools to inspect and optimize automations, scripts, scenes, and helpers in Home Assistant. It uses API‑Key authentication and is intended for users who want to programmatically interact with their Home Assistant configuration.
How to use Home Assistant MCP Server?
Clone the repo, copy .env.example to .env and fill in values, then run npm install, npm run build, and npm start. The server runs at http://localhost:${PORT}/sse (default port 8080). Authenticate requests using the X-API-Key header.
Key features of Home Assistant MCP Server
- SSE transport with API‑Key authentication
- Tools:
get_automations,get_scripts,get_scenes,get_helpers - Optimization via
recommend_optimizations
Use cases of Home Assistant MCP Server
- List all automations in your Home Assistant instance
- Retrieve all scripts, scenes, or helpers
- Get simple optimization recommendations based on your configuration
FAQ from Home Assistant MCP Server
What transport does Home Assistant MCP Server use?
It uses SSE (Server‑Sent Events) transport.
How do I authenticate with the server?
Set the X-API-Key header in requests.
What tools are available?
get_automations, get_scripts, get_scenes, get_helpers, and recommend_optimizations.
How do I start the server?
After setup, run npm start. The server listens on http://localhost:${PORT}/sse (default port 8080).
Does the server require a running Home Assistant instance?
The README does not specify whether a Home Assistant instance must be running; it only details the MCP server setup.
