ha-mcp is a comprehensive Model Context Protocol (MCP) server designed to enable AI assistants to interact with Home Assistant. It allows users to control smart home devices, query states, execute services, and manage automations using natural language.

ha-mcp: A comprehensive Model Context Protocol (MCP) server designed to enable… (★ 4k, MIT)

Features

01Natural language control over smart home devices and services.

02Management of Home Assistant automations, scripts, helpers, and dashboards.

03Monitoring and debugging of Home Assistant system, including history, logs, and automation traces.

04Comprehensive search capabilities for entities and configurations.

05Built-in safety features like Read Only Mode and tool security policies.

Why choose it

+Natural language control over smart home devices and services.

+Creating and modifying Home Assistant automations based on natural language commands.

+Covers 9 supported environments or platforms, which is helpful for broader deployment needs.

+Ships with a public repository and a MIT license, which makes adoption and review easier.

Trade-offs

!There are at least 8 related tools in the same category, so the best choice is easier to make after side-by-side comparison.

Compatibility

Python

Runtime

Verified via docs

Home Assistant

Platform

Verified via docs

MacOS

Verified via docs

Linux

Verified via docs

Windows

Verified via docs

Home Assistant OS

Add-on

Verified via docs

Quick start

$ curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

Use cases

↳Creating and modifying Home Assistant automations based on natural language commands.

↳Debugging smart home issues by analyzing automation traces and system logs.

↳Controlling multiple devices or executing complex routines with a single natural language request.

↳Adding or updating UI elements like dashboard cards.

↳Managing Home Assistant configurations like areas, zones, and helper entities.

How it compares

≈ha-mcp sits in the Workflow Automation category, so it makes more sense to evaluate it alongside tools like Gemini CLI instead of in isolation.

≈If your main need is closer to "Creating and modifying Home Assistant automations based on natural language commands.", that use case is a better lens for comparison than broad feature checklists alone.

≈ha-mcp uses a MIT license, and community traction are both easier to judge in category context.