Skip to content

Summary

Open-source MCP server for configuring and controlling Home Assistant from Claude, ChatGPT and other assistants: automations, dashboards, devices and backups.

Features

  • 86 tools for automations, scripts, dashboards, areas, calendars and blueprints
  • History, statistics, automation traces and camera snapshots
  • Runs inside Home Assistant via HACS or the 2026.11+ Marketplace
  • Read-only mode, per-tool toggles and automatic edit backups
  • Remote access through Nabu Casa or any reverse proxy

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "HA-MCP" tools will be available.
{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.14",
        "ha-mcp@latest"
      ]
    }
  }
}

Description

HA-MCP connects AI assistants to a Home Assistant installation so you can configure the smart home in plain language: "create an automation that turns on the porch light at sunset", "add a weather card to my dashboard" or "debug why the motion sensor automation isn't firing". It goes well beyond toggling devices: its 86 tools read and write automations, scripts, helpers, dashboards, areas and floors, zones, calendars and blueprints, read history, statistics, automation traces and camera snapshots, and manage backups, updates and add-ons.

The recommended install is the HA-MCP integration, which runs the server inside Home Assistant (2026.8 or newer) and is available from HACS or, from Home Assistant 2026.11, the built-in Marketplace. It can also run as a Home Assistant app (add-on) on HA OS and Supervised installs, as a Docker container, or from PyPI with uvx; remote clients connect through a webhook URL via Nabu Casa or any reverse proxy, with optional Home Assistant sign-in or OIDC in front.

Safety is built in: a read-only mode, per-tool enable and disable, approval policies for risky tools and automatic backups before edits. A setup wizard on the documentation site generates configs for more than 15 clients, and one-command scripts connect Claude Desktop to a hosted demo instance for a trial. MIT licensed.

Related MCP Servers

See all HA-MCP alternatives

Home Assistant's built-in MCP Server integration — lets Claude, ChatGPT and other MCP clients see and control exactly the smart-home entities you choose to expose.

Featured

Google's official MCP server for the Home ecosystem — let an agent list your homes and devices, read live trait state, run actions and query event history over OAuth.

MCP: tinymcp

by Golioth

Golioth's experimental MCP server that lets an LLM drive real embedded devices — device RPCs become MCP tools, with schemas stored in LightDB State and calls routed through the Golioth cloud.

New

Self-hosted MCP server for Xiaohongshu (RedNote): search notes, read feeds and comments, and publish image or video posts from an AI assistant.

Browse all MCP servers →