Home Assistant MCP Server
Enables interaction with a Home Assistant instance, including controlling smart home devices, querying states, calling services, managing automations, scripts, helpers, dashboards, areas, zones, groups, calendars, blueprints, backups, and system information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Home Assistant MCP Serverturn off the living room lights and set the thermostat to 68 degrees"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
The Unofficial and Awesome Home Assistant MCP Server

๐ 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)
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 | shDownload 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 โ
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 | iexDownload 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
Related MCP server: Home Assistant MCP Server (HA-mcp)
๐ฌ 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 configuring, more time enjoying your smart home.
โจ Features
Category | Capabilities |
๐ 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, calendars, blueprints |
๐ Monitor | History, statistics, camera snapshots, automation traces, ZHA devices |
๐พ System | Backup/restore, updates, add-ons, device registry |
Category | Tools |
Search & Discovery |
|
Service & Device Control |
|
Automations |
|
Scripts |
|
Helper Entities |
|
Dashboards |
|
Areas & Floors |
|
Labels |
|
Zones |
|
Groups |
|
Todo Lists |
|
Calendar |
|
Blueprints |
|
Device Registry |
|
ZHA & Integrations |
|
Add-ons |
|
Camera |
|
History & Statistics |
|
Automation Traces |
|
System & Updates |
|
Backup & Restore |
|
Utility |
|
๐งช Dev Channel
Want early access to new features and fixes? Dev releases (.devN) are published on every push to master.
Dev Channel Documentation โ Instructions for pip/uvx, Docker, and Home Assistant add-on.
๐ค Contributing
For development setup, testing instructions, and contribution guidelines, see CONTRIBUTING.md.
For comprehensive testing documentation, see tests/README.md.
๐ Privacy
Ha-mcp runs locally on your machine. Your smart home data stays on your network.
Configurable telemetry โ optional anonymous usage stats
No personal data collection โ we never collect entity names, configs, or device data
User-controlled bug reports โ only sent with your explicit approval
For full details, see our Privacy Policy.
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
๐ Acknowledgments
Home Assistant: Amazing smart home platform (!)
FastMCP: Excellent MCP server framework
Model Context Protocol: Standardized AI-application communication
Claude Code: AI-powered coding assistant
๐ฅ Contributors
@julienld โ Project maintainer & core contributor.
@kingbear2 โ Windows UV setup guide.
@sergeykad โ Dashboard card-level CRUD operations, better changelogs and removed the dependency to textdistance/numpy.
@konradwalsh โ Financial support via GitHub Sponsors. Thank you! โ
@cj-elevate โ Integration & entity management tools (enable/disable/delete).
@kingpanther13 โ Dev channel documentation, bulk control validation, OAuth 2.1 docs, tool consolidation, error handling improvements, and native solutions guidance.
@Danm72 โ Entity registry tools (
ha_set_entity,ha_get_entity) for managing entity properties.@Raygooo โ SOCKS proxy support.
๐ฌ Community
GitHub Discussions โ Ask questions, share ideas
Issue Tracker โ Report bugs, request features, or suggest tool behavior improvements
โญ Star History
This server cannot be deployed
Maintenance
Related MCP Connectors
Home energy for AI assistants: live Power flow, Energy history, solar forecast, and device control.
- mytesla.ioOAuthio.mytesla
Control your Tesla from your AI assistant - climate, charging, access, and security.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with Home Assistant to control smart home devices, query entity states, and manage automations using natural language. It provides over 90 tools for comprehensive system management, including dashboard configuration, service execution, and automation debugging.MIT
- AlicenseAqualityFmaintenanceEnables controlling and querying Home Assistant devices and services via natural language. Supports state retrieval, listing states, and calling any Home Assistant service.1352 npm5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Home Assistant via natural language, including device control, automation management, and system monitoring.MIT