Home Assistant

Home Assistant

Bridge between Home Assistant and LLMs using MCP for natural language control.

478
Stars
43
Forks
0
Releases

Overview

The MCP server for Home Assistant exposes a local Home Assistant instance to language models via the Model Context Protocol. It serves as a powerful bridge between your Home Assistant environment and LLM applications, enabling natural language control and monitoring of devices, automations, and system state. The server provides a comprehensive API to manage your entire Home Assistant ecosystem—from device control to administrative tasks—while delivering real-time updates through Server-Sent Events (SSE). With support for core device domains (lights, climate, covers, switches, sensors, media players, fans, locks, vacuums, cameras) and extended features like add-on management and HACS-based package management, users can query states, manage contexts, execute actions, and orchestrate automations. The API supports actions, batches, context queries, and state management, and is complemented by WebSocket events for streaming updates and robust error handling. Security is enforced via token-based authentication and rate limiting. The project emphasizes TypeScript type safety, thorough testing, containerized deployment with Docker, environment-driven configuration, and documentation to facilitate integration with clients such as Claude Desktop and other MCP-enabled applications.

Details

Owner
tevonsb
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

Device Control

Control any Home Assistant device through natural language via a unified MCP-enabled API.

Real-time Updates (SSE)

Receive instant state changes, automation triggers, service calls, and scripts via Server-Sent Events.

Automation Management

Create, update, enable/disable, duplicate, and manually trigger automations with advanced configuration.

State Monitoring

Track and query device states with robust state management and historical context access.

Secure API & Rate Limiting

Token-based authentication with rate limiting to protect endpoints.

Mobile Ready

Accessible from any HTTP-capable client, including mobile applications.

Add-on Management

Browse, install, start/stop/restart, and manage add-ons along with versioning and configuration access.

Package Management (HACS)

Integrate with Home Assistant Community Store (HACS) for packages, including integrations, themes, Python scripts, and more.

Audience

LLM developersBuild AI assistants that control and monitor a Home Assistant instance via MCP.
Home Assistant enthusiasts / operatorsLeverage MCP-enabled LLM apps for natural language control and comprehensive monitoring of their Home Assistant ecosystem.

Tags

Home AssistantMCPLLM integrationServer-Sent EventsSSEDevice controlAutomationState monitoringAdd-on managementPackage managementHACSDockerTypeScriptAPI