#44th of 12 in MCP servers

ha-mcp

MCP server that lets AI assistants configure and control Home Assistant

Documentation ↗ Website ↗ Repository on GitHub ↗

Stars: 7.1k
License: MIT
Last commit: Nov 2026
Last release: Nov 2026
Language: Python

Stars, last 29 weeks+3,833

3,230 on 20 Apr 20267,063 on 9 Nov 2026

From GitHub's daily star counts.

Checked 11 Nov 2026 on GitHub.

Overview

ha-mcp exposes 87 tools over the Model Context Protocol so clients such as Claude, ChatGPT and Cursor can search entities, control devices, and create or edit automations, scripts, helpers and dashboards in Home Assistant. It is built on FastMCP and installs as an in-process HACS/Marketplace integration, a Home Assistant app (add-on), Docker, or uvx/PyPI. Safety features include read-only mode, per-tool disabling and automatic edit backups.

Who it is for: Home Assistant users who want MCP clients to manage their smart home

Strengths

87 tools covering automations, dashboards, helpers, areas, backups, traces and device registry
In-process integration works on OS, Supervised, Container and Core installs
Read Only Mode, per-tool enable/disable and automatic backups before edits
Setup Wizard generates config for 15+ clients; demo server available to try first

Weaknesses

Integration requires Home Assistant 2026.8.0 or newer
Acts with an administrator token; a leaked token or secret URL grants broad access
stdio transport has known connection problems; README recommends it only for demos
Several install paths exist; running more than one per client causes connection hangs

What it needs

no GPU
Docker + Compose
Needs Home Assistant 2026.8.0+, Home Assistant administrator access token, FastMCP
Models: Claude, ChatGPT, Gemini CLI, Open WebUI, Cursor
port 9584

What changed

From the release notes. No flag means the note does not say so, not that the upgrade is safe.

Quick answers

Is ha-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Can you run ha-mcp with Docker?

Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.

Does ha-mcp need a GPU?

No, it runs without one.

Head to head

Also in MCP servers

See all 12

Also in MCP servers
Rank	Project	Score
1	serversReference MCP servers for files, git, fetch, memory and time91.9k starscustom license	94 out of 100
2	apify-mcp-serverOfficial MCP server exposing Apify Store Actors as tools for web scraping15.7k stars+5,088 (+48%) in 30 daysMIT	86 out of 100
3	xiaohongshu-mcpMCP server that lets AI clients post, search and comment on Xiaohongshu17.1k stars+912 (+5.6%) in 30 daysApache-2.0	85 out of 100
#5	mcp-atlassianMCP server exposing Jira and Confluence tools to AI assistants6.1k stars+140 (+2.3%) in 30 daysMIT	69 out of 100
#6	figma-console-mcpMCP server that reads and writes Figma files, variables and components3.3k stars+819 (+33%) in 30 daysMIT	68 out of 100

How to choose

Check what it can write or delete, not only what it reads.
Prefer servers that scope credentials per tool or per user.
See whether it runs locally (stdio) or as a remote server you have to secure.

Health

Releases: 95 in the last 12 monthsLast one 3 days ago
Top contributor: 42% of commits634 of 1,492 in the last 12 months
Security advisories: 6 published ↗ (opens in a new tab)On GitHub, in the last 12 months; none critical or high
PyPI package: No known advisories ↗ (opens in a new tab)ha-mcp 9.1.2, the latest version
OpenSSF Scorecard: Not checked

Read from GitHub, deps.dev and OpenSSF on 9 Nov 2026. Bots and coding-agent accounts are left out of the commit counts. Not part of the score: how we check.

License in plain words

MIT Permissive

Use it at work: Yes
Change it and rebrand it: Yes
Sell it or host it for others: Yes

Your part: Keep the copyright and license notice in copies you ship.

A plain summary, not legal advice. Read the license on GitHub ↗ (opens in a new tab)

Set it up

Needs before it works: Home Assistant 2026.8.0+, Home Assistant administrator access token, FastMCP.

Bring in an engineer who knows ha-mcp. By the hour for upkeep and fixes, or a fixed price for a build. Our own engineering service; it never changes a rank.

Where to run it

RackNerd ↗ (opens in a new tab)Budget KVM VPS from $26.99 a year to run Docker apps yourself.
RepoCloud ↗ (opens in a new tab)One-click hosting for about 890 open-source apps, each on its own VPS.

Referral links: if you sign up through one, we get a commission. They never change a rank.

Ask your AI assistant

The rankings as an MCP server for Claude, Cursor, ChatGPT and any MCP client. Free, no key, read-only.

Setup for other apps

Claude Codeclaude mcp add archestack -- npx -y @archestack/mcp

Connector URLhttps://mcp.archestack.com/mcp

Then ask: Compare ha-mcp with its top alternatives on Archestack

#4 of 12 in MCP servers on Archestack, as of 11 Nov 2026.

Show it in your README or on your site

The badge below goes in a README; a card with the rank, score and signals goes on a site or blog. Both update twice a day.

Show code

README (Markdown)

[![Archestack](https://archestack.com/badge/homeassistant-ai/ha-mcp.svg)](https://archestack.com/best-of-ai/projects/ha-mcp/)

Site or blog (HTML)

<iframe src="https://archestack.com/embed/best-of-ai/ha-mcp/" title="ha-mcp on Archestack" width="400" height="270" style="border:0;max-width:100%" loading="lazy"></iframe>

How badges work Preview the card

Best of Open-Source AI on GitHub

Each review comes from the project's README and facts we check on GitHub. The fix form opens with ha-mcp filled in.

Chat and assistants

Agents and MCP

RAG, search and memory

Voice

Image and video

Workflows

Coding with AI

Apps and SaaS

Models and ML

Security

Learning

By field