---
slug: "haproxy-mcp-server"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/Nutti85/ha-mcp-server@main/README.md"
repo: "https://github.com/Nutti85/ha-mcp-server"
source_file: "README.md"
branch: "main"
---
# 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