mcp-server

ha-mcp: Boost Home Assistant Automation with a Proven MCP Server

ha-mcp delivers a robust, community‑backed MCP server for Home Assistant, letting founders streamline device communication and AI integration. 5.1k+ GitHub stars.

From the repo · “The Unofficial and Awesome Home Assistant MCP Server”

5,166 stars+94★ this week242 forksPythonGuide quality 8/10 · reviewed Oct 19Updated 10/21/2026100% free · open source
What it does

The ha-mcp server enables Home Assistant users to leverage the power of MCP for home automation, allowing for more advanced and customized automation scenarios.

When to use it
  • •You're already using Home Assistant and want to integrate MCP for more complex automation rules.
  • •You need a more customizable and extensible home automation solution.
  • •You're looking for a community-driven, open-source alternative to proprietary home automation platforms.
Ready-to-paste prompt
python -m ha_mcp.server --config config.yaml --host 0.0.0.0 --port 8080
Heads up: You need to have Python 3.9 or later installed, as well as a compatible version of Home Assistant, to run ha-mcp successfully.
Saves to your device
Use with Claude
New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install
Claude Code
mkdir -p ~/.claude/skills/ha-mcp && curl -fsSL https://workflowstacks.com/api/skills/ha-mcp/claude-skill -o ~/.claude/skills/ha-mcp/SKILL.md
Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)
claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How ha-mcp: Boost Home Assistant Automation with a Proven MCP Server works
Codeflow
Free to inspect

Ha-mcp: Boost Home Assistant Automation with a Proven MCP Server is a very large Python project (~330k lines across 704 code files, plus 743 test files). Setup is light: installs like a normal app — add your API keys. Reading the code is optional. Last commit this month, MIT license, has a test suite.

Size
Very large codebase
~330k lines · 704 code files · days to read — use, don't read
Setup
One-command install
Installs like a normal app — add your API keys. Reading the code is optional.
Runs on
Python · Docker
Needs API keys (.env)
Python 97%Astro 2%JavaScript 1%
Where to start reading
  1. 1
    README.md
    Start here — what it does and how to install it
  2. 2
    AGENTS.md
    The instructions the AI actually follows
  3. 3
    homeassistant-addon/start.py
    Where the program starts running
  4. 4
    pyproject.toml
    Dependencies and the commands it exposes
  5. 5
    .env.example
    The API keys and settings you must provide
What's in each folder
src/Core code — the actual logic678 files
rules/Prompts, skills & agent definitions3 files
site/Frontend / UI54 files
docs/Documentation18 files
templates/Templates1 files
custom_components/Folder53 files
homeassistant-addon/Folder24 files
scripts/Helper scripts23 files
READMEHas testsDocumentedCI checksDocker readyMIT licenseUpdated this month
Quick Actions
Details
Creator
homeassistant-ai
Language
Python
Category
mcp-server
Published
9/14/2025

Are you the creator of this tool? and earn 85% of every sale.

Show it off in your README:

Featured on WorkflowStacks
[![Featured on WorkflowStacks](https://workflowstacks.com/api/badge/ha-mcp.svg)](https://workflowstacks.com/skills/ha-mcp?utm_source=github&utm_medium=badge)
🔥 Hot this week, in your inbox
Skills like this, every Monday.

The five fastest-growing open-source AI skills, ranked by GitHub star growth. One email a week, unsubscribe anytime.

Do this with a working workflow

Pages we wrote and tested that put a skill like this to work — importable n8n templates, outcome guides and Claude Desktop configs.