homeassistant-ai/ha-mcp

The Unofficial and Awesome Home Assistant MCP Server

What it solves

It allows AI assistants (like Claude or ChatGPT) to directly interact with a Home Assistant smart home setup. Instead of manually configuring devices and automations, users can use natural language to control their home, query device states, and manage the underlying system configuration.

How it works

The project implements a Model Context Protocol (MCP) server. This server acts as a bridge between an AI client and the Home Assistant API. It provides a comprehensive set of tools (87 in total) that the AI can call to perform actions such as executing services, reading entity states, editing YAML configurations, and managing dashboards.

Who it’s for

Smart home enthusiasts and Home Assistant users who want to integrate their AI assistants into their home automation ecosystem for easier control and control and configuration.

Highlights

  • Extensive Toolset: Provides 87 tools covering search, device control, automation management, and system administration.
  • Multiple Deployment Options: Can be installed as a Home Assistant custom component (via HACS), a Home Assistant app/add-on, a Docker container, or a standalone Python package.
  • Natural Language Configuration: Enables AI to create automations, scripts, and dashboard cards using plain text commands.
  • Safety Features: Includes a "Read Only Mode" toggle, tool-specific enable/disable settings, and automatic backups for edits.
  • Remote Access: Supports various remote connectivity methods including Nabu Casa, webhooks, and OIDC authentication.

Related

  • Project
  • Project
  • Project
  • Project
  • Project