Home Assistant MCP Server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant. Control smart home devices, query states, execute services and manage automations using natural language.
Quick Start (~5 min)
No paid subscription required. Just copy-paste one command.
macOS
- 1. Sign in to claude.ai
- 2. Open Terminal and run:
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh- 3. Download Claude Desktop
- 4. Ask Claude: "Can you see my Home Assistant?"
Windows
- 1. Sign in to claude.ai
- 2. Open PowerShell and run:
irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex- 3. Download Claude Desktop
- 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 Claude 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
🔍 Search
Fuzzy entity search, deep config search, system overview
🏠 Control
Any service, bulk device control, real-time states
🔧 Manage
Automations, scripts, helpers, dashboards, areas, zones, groups
📊 Monitor
History, statistics, camera snapshots, automation traces
💾 System
Backup/restore, updates, add-ons, device registry
🛠️ 82+ Tools
Comprehensive toolset for complete HA control
Ready to Get Started?
Set up ha-mcp with your AI assistant in minutes
Open Setup Wizard