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 Add ha-mcp add-on repository to your Home Assistant View on GitHub
Demo with Claude Desktop

Quick Start

No paid subscription required. Copy-paste one command to install.

macOS

Terminal

  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

  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

  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, 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