homeassistant-mcp

290
os_automationcommunicationdeveloper_tools

This project creates a bridge between Home Assistant and Language Learning Models, enabling natural language control of smart home devices via the Model Context Protocol. It offers a robust API for device control, automation management, and secure operations, suitable for integration with various platforms.

Model Context Protocol Server for Home Assistant

A powerful bridge between your Home Assistant instance and Language Learning Models (LLMs), enabling natural language control and monitoring of your smart home devices through the Model Context Protocol (MCP). This server provides a comprehensive API for managing your entire Home Assistant ecosystem.

Features

  • Device Control: Control devices through natural language
  • Real-time Updates: Instant updates through Server-Sent Events
  • Automation Management: Create and manage automations
  • State Monitoring: Track device states
  • Secure: Token-based authentication

Installation

Docker Setup (Recommended)

  1. Clone the repository
  2. Configure environment variables
  3. Build and run with Docker Compose
  4. Verify the installation at http://localhost:3000

Development

  • Development mode with hot reload using npm run dev
  • Build project using npm run build
  • Run tests using npx jest