ha-mcp

Level ALocal

Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.

Overview

ha-mcp is an unofficial Home Assistant MCP server that lets AI assistants control smart home devices, query states, execute services, and manage automations using natural language. It offers around 87 tools and can run in-process via a HACS custom component across Home Assistant OS, Supervised, Container, and Core installs, with an app (add-on) option as well.

⭐ 8kDevelopment ToolsPythonRepo ↗Updated 2026-11-20

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/homeassistant-ai/ha-mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers