README.md
Interact with Home Assistant to control smart home devices and automations.
The Unofficial and Awesome Home Assistant MCP Server
<em>A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
Using natural language, control smart home devices, query states, execute services and manage your automations.</em>
🚀 Get Started
Full guide to get you started with Claude Desktop (~10 min)
No paid subscription required. Click on your operating system:
Quick install (~5 min)
🍎 macOS
- Go to claude.ai and sign in (or create a free account)
- Open Terminal and run:
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh - Download Claude Desktop (or restart: Claude menu → Quit)
- Ask Claude: "Can you see my Home Assistant?"
You're now connected to the demo environment! Connect your own Home Assistant →
🪟 Windows
- Go to claude.ai and sign in (or create a free account)
- Open Windows PowerShell (from Start menu) and run:
irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex - Download Claude Desktop (or restart: File → Exit)
- Ask Claude: "Can you see my Home Assistant?"
You're now connected to the demo environment! Connect your own Home Assistant →
🧙 Setup Wizard for 15+ clients
Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor, and more.
Having issues? Check the FAQ & Troubleshooting
💬 What Can You Do With It?
Just talk to Claude naturally. Here are some real examples:
| You Say | What Happens |
|---|---|
| "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 |
| "Make my morning routine automation also turn on the coffee maker" | Reads the existing automation, adds the new action, updates it |
| "Create a script that sets movie mode: dim lights, close blinds, turn on TV" | Creates a reusable script with the sequence of actions |
Spend less time
Tools (3)
control_deviceTurn devices on or off or adjust their settings.query_stateGet the current state or attributes of a specific entity.manage_automationCreate, update, or debug Home Assistant automations.Environment Variables
HA_URLrequiredThe base URL of your Home Assistant instanceHA_TOKENrequiredLong-lived access token for Home AssistantConfiguration
claude_desktop_config.json
{"mcpServers": {"home-assistant": {"command": "uvx", "args": ["ha-mcp"], "env": {"HA_URL": "http://homeassistant.local:8123", "HA_TOKEN": "your-long-lived-access-token"}}}}Try it
→Create an automation that turns on the porch light at sunset
→Add a weather card to my dashboard
→The motion sensor automation isn't working, debug it
→Make my morning routine automation also turn on the coffee maker
→Create a script that sets movie mode: dim lights, close blinds, turn on TV