ha-mcp

ha-mcp

Lets Claude, ChatGPT and other AI assistants configure and automate Home Assistant, installed as an integration through HACS or the Marketplace. For people who run their own Home Assistant.

Made by homeassistant-ai on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

About

What it is: ha-mcp connects AI assistants such as Claude and ChatGPT to Home Assistant so they can configure and automate it. The recommended route is the HA-MCP integration, which runs the full server inside Home Assistant itself. It runs on all four Home Assistant installation types and offers the same features on each.

Who it suits: People who run their own Home Assistant and want an AI assistant to help set it up fit best. Self-hosters on any install type can use it, since the integration behaves the same everywhere.

Industry | Who uses it | How they use it | Example
Smart home | Home Assistant owners | Ask an AI assistant to configure and automate their setup | Asking an assistant to set up a new automation in plain language
Self-hosting | Owners of OS, Supervised, Container or Core installs | Add the integration to the install they already have | One setup path that works on every install type
Integration work | People connecting several assistants | Choose during setup how clients may connect | Claude and ChatGPT both reaching the same Home Assistant

Skip it if you do not run Home Assistant.

Where to use it: Inside your own Home Assistant, with an AI assistant as the client.

• Home Assistant OS, Supervised, Container and Core
• HACS on Home Assistant 2026.8 to 2026.10
• The Marketplace inside Home Assistant, from version 2026.11
• Claude, ChatGPT and other AI assistants as clients

Use case | Who | What they get back
Configure Home Assistant | Home owners | Changes to the setup made through a conversation
Automate the home | Home owners | Automations created by asking an assistant
Connect another assistant | Integrators | A choice of how each client may connect

How to set it up: You need a running Home Assistant 2026.8.0 or newer and an administrator access token.

• Home Assistant 2026.8.0 or newer
• HACS on 2026.8 to 2026.10, or the Marketplace on 2026.11 and later
• An administrator access token, which the setup asks for

1. With a version from 2026.8 to 2026.10, open HACS, look up HA-MCP and download it.
2. With 2026.11 or newer, go to Settings, then Marketplace, and accept the warning shown on first use.
3. Search for HA-MCP and choose Install.
4. In the setup form, give the administrator access token and choose how clients may connect.

How to use it: Once the integration is running, you connect your AI assistant as a client and ask it to configure or automate Home Assistant. It does the work through the server inside your installation.

For newcomers and experts: If you are new, think of this as a bridge between your chat assistant and your smart home. A good first step is to check that your Home Assistant is on 2026.8.0 or newer, then install the integration.

If you know the field, this is a Model Context Protocol server that runs in-process inside Home Assistant rather than as a separate service. That gives the same features on all install types. The trade-off is that it acts with an administrator token, so you decide carefully which clients may connect.

You install HA-MCP through HACS or the Marketplace
Setup takes a token and client rules
Your assistant connects as a client
It configures and automates Home Assistant

Good to know: Version 7.3.0 moved the YAML config-setting tool to beta. The administrator account step appears from 9.0.0 on, and older versions have a shorter form.

• License: MIT
• Cost to run: A Home Assistant installation and an administrator access token. The source names no paid service.
• Data it reaches: Your Home Assistant installation, through the administrator token, so an assistant can change its configuration.
• Not for: Home Assistant older than 2026.8.0.

On GitHub, 10 November 2026

• Stars: 6,025 (31 that day)
• Forks: 295
• Watching: 20
• Open issues and pull requests: 24
• Language: Python
• License: MIT
• Topics: ai, claude, hacs, home-assistant, home-automation, llm, mcp, model-context-protocol
• Trending: #10 repository of the day on GitHub trending (10 November 2026)

Links

• Code: https://github.com/homeassistant-ai/ha-mcp
• Website: https://homeassistant-ai.github.io/ha-mcp/
• Releases: https://github.com/homeassistant-ai/ha-mcp/releases
• Issues: https://github.com/homeassistant-ai/ha-mcp/issues
• Star history: https://www.star-history.com/#homeassistant-ai/ha-mcp&Date

Get the code

git clone https://github.com/homeassistant-ai/ha-mcp.git

Then follow the setup in its README. Nothing in this kit runs by itself.