Breaking change (v7.3.0): ha_config_set_yaml has been moved to beta.

The Unofficial and Awesome Home Assistant MCP Server

<img src="https://img.shields.io/badge/tools-85-blue" alt="95+ Tools">






<img src="https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fhomeassistant-ai%2Fha-mcp%2Fmaster%2Fpyproject.toml" alt="Python Version">





<em>A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
Using natural language, control smart home devices, query states, execute services and manage your automations.</em>

---

---

🚀 Get Started

Set up for your operating system — you'll pick Local (Claude Desktop) or the Home Assistant App on the setup page:

        

Prefer to set it up by hand? The detailed paths are below.

🏠 Recommended: Home Assistant App (add-on)

Running Home Assistant OS? Run ha-mcp inside Home Assistant — no access token to manage, works with Claude Desktop, Claude.ai, ChatGPT and any other MCP client, and can stay on your local network or be configured for remote / HTTP access.

1. Add the repository to your Home Assistant instance:

   

   If that opens the App Store without an add-repository dialog (a known Home Assistant issue), add it manually: App Store → ⋮ → Repositories, then paste https://github.com/homeassistant-ai/ha-mcp.

2. Install "Home Assistant MCP Server" from the App Store and click Start. (Home Assistant 2026.2 renamed "Add-ons" to "Apps"; on older versions this is the Add-on Store.)

3. Open the Logs tab to find your unique MCP URL

4. Connect your AI client to that URL — no token or credential setup needed

Full add-on documentation →

⚠️ Two ways to run ha-mcp — don't mix them. The add-on above is the recommended path. The local stdio path below runs ha-mcp on your own computer; it is more advanced, has fewer features, and is behind most connection problems. If you use the add-on, your Claude Desktop config points at the add-on URL through mcp-proxy with no token — do not also keep a local uvx ha-mcp@latest entry (with HOMEASSISTANT_URL / HOMEASSISTANT_TOKEN) in your Claude Desktop config. Running both at once is a known cause of connection hangs.

💻 Run locally with Claude Desktop (stdio · advanced)

No paid subscription required. This runs ha-mcp on your own machine over stdio.

Quick install (~5 min)

1. Go to claude.ai and sign in (or create a free account)
2. Open Terminal and run:

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

3. Download Claude Desktop (or restart: Claude menu → Quit)
4. Ask Claude: "Can you see my Home Assistant?"

You're now connected to the demo environment! Connect your own Home Assistant →

Anthropic doesn't ship Claude Desktop for Linux, so pick one path:

Claude Desktop — free, via the community build:

---

GitHub에서 전체 내용 보기