Home Assistant
MCP Server

A Model Context Protocol server that enables AI assistants to interact with Home Assistant. Control devices, query states, manage automations, and configure dashboards using natural language.

Get Started Install the HA-MCP custom component via HACS (preferred install) View on GitHub
Demo with Claude Desktop

Quick Start

No paid subscription required.

HA Custom Component

Recommended — every Home Assistant installation type

Runs the full ha-mcp server inside Home Assistant — every installation type (Home Assistant OS, Supervised, Container, Core), with full feature parity. Reachable on your local network, or remotely through a built-in Home Assistant webhook via Nabu Casa or your reverse proxy. Works with Claude Desktop, Claude.ai, ChatGPT and any other MCP client.

  1. 1. Install HA-MCP Custom Component from HACS, then restart Home Assistant.
  2. 2. Settings → Devices & Services → Add Integration, then choose HA-MCP Server.
  3. 3. Copy the URL from the entry's Configure screen, connect your client, and ask: "Can you see my Home Assistant?"
Install via HACS Full docs → Setup Wizard →

Prefer the add-on (Home Assistant OS)? App setup guide →

Try the demo server (local stdio)

stdio · demo server · not recommended

macOS

Terminal · stdio

  1. 1. Sign in to claude.ai
  2. 2. Run in Terminal:
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh
  1. 3. Download Claude Desktop
  2. 4. Ask Claude: "Can you see my Home Assistant?"

Linux

Terminal · stdio

  1. 1. Sign in to claude.ai
  2. 2. Run in Terminal:
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-linux.sh | sh
  1. 3. Install the community Claude Desktop for Linux build
  2. 4. Ask Claude: "Can you see my Home Assistant?"

Prefer the official CLI? Claude Code setup →

Windows

PowerShell · stdio

  1. 1. Sign in to claude.ai
  2. 2. Run in PowerShell:
irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex
  1. 3. Download Claude Desktop
  2. 4. Ask Claude: "Can you see my Home Assistant?"

Need more options? Use the Setup Wizard

What Can You Do With It?

Just talk to your AI assistant naturally. Here are some examples:

"Create an automation that turns on the porch light at sunset"

Creates the automation with proper triggers and actions

"Add a weather card to my dashboard"

Updates your Lovelace dashboard with the new card

"The motion sensor automation isn't working, debug it"

Analyzes execution traces, identifies the issue, suggests fixes

"Create a script that sets movie mode: dim lights, close blinds, turn on TV"

Creates a reusable script with the sequence of actions

Features

92+ tools across 6 categories.

Search

Fuzzy entity search, deep config search, full system overview

Control

Any service call, bulk device operations, real-time state tracking

Manage

Automations, scripts, helpers, dashboards, areas, zones, groups

Monitor

History, statistics, camera snapshots, automation traces

System

Backup and restore, updates, apps (add-ons), device registry

Flexible

Works with Claude, ChatGPT, Cursor, Copilot, and 15+ AI clients

Ready to Get Started?

Set up ha-mcp with your AI assistant in minutes.

Open Setup Wizard