Ha MCP: MCP server, setup and security

What Ha MCP does

According to its repository: “Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.”

The Model Context Protocol (MCP) is a standard plug between an AI agent and an outside service: once the server is connected, its tools show up in the agent, which decides when to call them. Ha MCP is listed under Smart home and IoT, a category of 34 servers in the directory, where it ranks #1 by stars.

Topics declared by the repository: claude, hacs, home-assistant, home-automation.

Installing and connecting Ha MCP

Distribution modes declared in the official MCP registry:

• PyPI package (Python, started with uvx or pip)
• Docker (OCI) image

It works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, VS Code, Codex and most recent agents). You add one entry to the client's MCP configuration: server name, start command or URL, environment variables. Project language: Python.

Security: what to check

Connecting an MCP server means installing software that talks straight to your agent: it runs with your rights and the model trusts its tool descriptions. The risk therefore depends on what it can touch and how far its code can be trusted.

None of the risk signals we track (system access, secrets, missing licence, abandonment) applies to Ha MCP. That does not replace reading the code.

Good practice: grant only the rights needed (least privilege), require human approval for irreversible actions, and run the AI agent security check.

Project activity and maintenance

Created on September 14, 2025, the homeassistant-ai/ha-mcp repository has 5,199 stars and 244 forks, with 12 open issues. It has more stars than 97% of the servers in the directory. It received changes this month. Version published in the registry: 8.7.0 (October 14, 2026).

Stars measure attention, not quality: a recent, heavily promoted project can collect them fast, while a useful but niche server will have few.