homeassistant-ai/ha-mcp

The Unofficial and Awesome Home Assistant MCP Server

About the project

ha-mcp is an unofficial Model Context Protocol server that lets AI assistants interact with Home Assistant, including controlling devices, checking states, running services, and managing automations. Home Assistant users can connect it through the HA-MCP custom component or another supported setup. The catalogue entries are skills, agents, instructions, settings, and an MCP configuration for working with it.

Latest release v8.7.0 · 14 Oct 2026

3 files for Claude Code, Codex and OpenCode: ha-mcp, ha-mcp AGENTS.md, ha-mcp CLAUDE.md — 3,316 tokens loaded in every session.

5,280Stars on the repository
3Files it configures its agents with
3,316Tokens loaded in every session
3Agents configured
▶ Home Assistant MCP: One Server for Claude, Codex, and Gemini CLI Josh Uses Ai · about homeassistant-ai/ha-mcp · on YouTube →

Instructions

Settings

These files are homeassistant-ai/ha-mcp's own configuration — they tell Claude Code, Codex and OpenCode how to work on this repository, so they are not mods to install elsewhere. Copy one as a starting point and replace the parts that are about this project.