A comprehensive Model Context Protocol (MCP) server enabling AI assistants to interact with Home Assistant via natural language. It empowers users to control smart home devices, query states, manage automations, and more, simplifying smart home management for Home Assistant users seeking an AI-driven interface.

How It Works

The project implements an MCP server that acts as a bridge between AI models and Home Assistant. It exposes a comprehensive suite of 82 tools, facilitating AI-driven execution of tasks such as entity searching, device control, automation management, and system monitoring. This architecture translates natural language commands into actionable Home Assistant operations.

Quick Start & Requirements

• Installation:
  • macOS: curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh
  • Windows: irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex
• Prerequisites: Requires an active Home Assistant instance and a compatible AI client (e.g., Claude Desktop, Gemini CLI, ChatGPT, Open WebUI).
• Setup Time: Approximately 5 minutes for quick install.
• Resources: Links to claude.ai, Claude Desktop download, and detailed guides are provided.

Highlighted Details

• Supports over 15 AI clients, including Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, and Cursor.
• Features 82 tools for extensive Home Assistant management: entity search, device control, automation/script creation, dashboard manipulation, system monitoring, and backups.
• Enables natural language control for complex tasks like automation debugging, routine creation, and dashboard updates.
• Operates locally, ensuring smart home data remains within the user's network.

Maintenance & Community

• Project maintainer and core contributor: @julienld.
• Community engagement via GitHub Discussions and the Issue Tracker.
• Financial contributions are accepted via GitHub Sponsors.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license permits commercial use and integration with closed-source applications.

Limitations & Caveats

The project is marked as "Unofficial," indicating it is not an official Home Assistant integration. Functionality is dependent on the capabilities and stability of external AI clients. Setup requires users to have a functional Home Assistant instance and configure AI client integration.