ha-mcp for Home Assistant

by The Unofficial Home Assistant AI ToolkitConnectorGet organised

Lets your AI assistant control, build and fix automations in your Home Assistant

About ha-mcp for Home Assistant

ha-mcp lets an AI assistant work with your Home Assistant smart home in plain words: turn devices on, build or fix automations, add dashboard cards and explain why a rule did not run.

For Home Assistant ownersSmart home tinkerers

Made by The Unofficial Home Assistant AI Toolkit

A community project from the Home Assistant AI Toolkit group on GitHub. It is unofficial: it is not made by the Home Assistant team.

Stars: ★ 5.4k
License: MIT
Cost: Usage-based
Level: Intermediate
Runs: Self-hosted

Overview

ha-mcp is an unofficial, community-made MCP server for Home Assistant. Once it runs inside your Home Assistant, you paste its connect URL into an AI client and ask in plain words: turn devices on, create an automation, add a dashboard card or find out why a motion sensor rule did not fire. It suits Home Assistant owners who want an assistant that can also set up and maintain their smart home.

Unlike Home Assistant's built-in MCP server, it can create and edit automations, scripts and dashboards and read traces to debug them.

Try these first

Start with the first one: it is a small task you can check easily.

Give me an overview of my Home Assistant: areas, device counts and any unavailable devices. Don't change anything.First try · read-only
Create an automation that turns on the porch light at sunset.changes your setup
The [automation name] automation isn't working. Read its traces and tell me why.
Add a weather card to my main dashboard.changes your setup

Example prompts written by Agent Flows Hub.

Capabilities

From the creator's documentation.

Toolset	What your agent can do	Access
Search and overview	Finds entities, searches your configuration and summarises the system	Read
History and traces	Reads history, statistics, logs and automation traces to debug rules	Read
Device control	Calls any service and controls devices, one at a time or in bulk	Read + write
Automations and scripts	Creates, edits and removes automations, scripts, scenes and helpers	Read + write
Dashboards	Builds and edits dashboards and their cards	Read + write
System	Backups, updates, apps and HACS; read-only mode and per-tool switches limit what it can do	Read + write

Good to know

Ask an assistant to look over your Home Assistant and change it for you. It can list your devices, write an automation such as porch lights at sunset, and read automation traces to explain why a rule did not run.

Limits

The server acts as an administrator account and can change or delete automations, dashboards and devices. The project suggests a separate local-only account, and offers a read-only mode and per-tool switches.
Run only one install method per AI client; the project notes that two entries for the same server can make connections hang.

Notes by Agent Flows Hub (original project name: ha-mcp), written from the creator's documentation, not from running it ourselves. ha-mcp README: get started · ha-mcp setup wizard

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Open your AI agentClaude Code, Codex, Cursor or another agent that supports MCP.
Paste the install requestIt asks your agent to read the official instructions, tell you what it will connect to and wait for your OK.
Give it a first taskTurn on read-only mode, connect your client, and ask for an overview of your areas and devices. Compare the list with what Home Assistant shows.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

An AI agent that supports MCP, such as Claude Code, Codex or Cursor.
A running Home Assistant with administrator access
HACS or, on Home Assistant 2026.11 and newer, the built-in Marketplace
An AI client that accepts an MCP server URL
It connects to the internet. Your agent will show you what before installing.
Pay per use. The AI service it calls charges for what you use.

Details

Made by: The Unofficial Home Assistant AI Toolkit
License: MIT Terms
Works with: Claude Code, Gemini CLI, CursorAs stated by the creator
Runs on: Self-hosted server

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/ha-mcp/install.md

Other connectors

Korean Law MCP Lets your AI agent look up Korean laws and court decisions and check legal citations
Linear MCP Lets your AI agent find, create and update issues, projects and comments in Linear
Market Analysis MCP Lets your AI assistant pull market prices, run technical analysis and backtest strategies
MCP for Blender Lets your AI agent build and change 3D scenes in Blender from plain-language requests
MeiGen AI Design Lets ChatGPT, Claude or Cursor find visual ideas and make images and videos for you
MiniMax MCP Lets your AI agent create speech, cloned voices, images and videos with MiniMax

See all 52 connectors · An MCP server is missing or disconnected

GitHub