mcp-registry/homeassistant-mcp

    ==================
      
       /// MCP ///
      /// HOM ///
        
    ==================
        
    [server:online]
    [protocol:ready]

homeassistant-mcp

by tevonsb

Model Context Protocol server that exposes your Home Assistant instance to LLM-based applications through a secure, real-time HTTP/SSE/WebSocket API.

383
29
Open Source
GitHub

01

control

Issue commands (e.g., turn_on, turn_off, toggle, brightness, color, etc.) to control any Home Assistant entity such as lights, switches, climate devices, covers, fans, media players, locks, vacuums, cameras, and more.

02

addon

Browse, install, uninstall, start, stop, restart, and manage versions or configuration of Home Assistant Supervisor add-ons.

03

package

List, install, update, and otherwise manage Home Assistant Community Store (HACS) packages across all supported categories (integrations, plugins, themes, python_scripts, AppDaemon apps, NetDaemon apps).

04

automation_config

Create, duplicate, edit, enable/disable, and manually trigger Home Assistant automations with advanced configuration options for triggers, conditions, actions, and execution modes.

Installation

Prerequisites
• Node.js ≥ 18 and npm (or pnpm/yarn)
• A running Home-Assistant instance and a long-lived access token
Steps
1. Clone the repo
git clone https://github.com/tevonsb/homeassistant-mcp.git cd homeassistant-mcp
2. Install dependencies
npm install # or: pnpm install
3. Configure environment
• Copy the sample file if present: `cp .env.example .env`
• Set required vars in `.env`:
HOMEASSISTANT_URL="http://<ha-host>:8123"
HOMEASSISTANT_TOKEN="<long-lived token>"
PORT=3111 # Port MCP should listen on (default 3111)
4. Build TypeScript → JavaScript
npm run build
5. Start the MCP server
npm start # or: node dist/index.js
6. (Optional) run in dev-watch mode
npm run dev
Container
docker build -t homeassistant-mcp . docker run -d --name hamcp -p 3111:3111 \ -e HOMEASSISTANT_URL=... \ -e HOMEASSISTANT_TOKEN=... homeassistant-mcp
The service will be available at http://localhost:3111 .

Documentation

License: Apache License 2.0
Updated 7/30/2025

Table of Contents