Home Assistant MCP Server
by
Enables AI assistants to control Home Assistant devices, query states, execute services, and manage automations using natural language.
Home Assistant MCP Server Overview
What is Home Assistant MCP Server about?
The project provides a comprehensive Model Context Protocol (MCP) server that bridges AI assistants (Claude, Gemini, ChatGPT, etc.) with Home Assistant. It lets users speak or type natural‑language commands to manipulate entities, create automations, view device history, and perform system tasks without leaving their AI chat interface.
How to use Home Assistant MCP Server?
- Installation – Run the platform‑specific install script (macOS:
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh; Windows:irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex). - Launch Claude Desktop (or another supported client) and ask a question such as "Can you see my Home Assistant?".
- Follow the on‑screen prompts to authorize the client with your Home Assistant instance. The server runs locally, so no external tunnelling is required.
- Use the built‑in Setup Wizard (accessible via the badge link) to add additional AI clients, configure OAuth, and enable bulk control.
Key features of Home Assistant MCP Server
- 🔍 Search & Discovery – Fuzzy entity lookup, deep configuration search, system overview.
- 🏠 Control – Call any service, bulk device actions, real‑time state queries.
- 🔧 Manage – Create, update, delete automations, scripts, helpers, dashboards, areas, zones, groups, calendars, blueprints, etc.
- 📊 Monitor – Access history, statistics, camera snapshots, automation traces, ZHA device details.
- 💾 System operations – Backup/restore, updates, add‑ons, device registry, health checks.
- 📦 97 built‑in tools – Exposed via MCP, covering every Home Assistant domain.
- 🛡️ Privacy‑first – Runs locally, optional telemetry, no automatic data collection.
Use cases of Home Assistant MCP Server
- Voice‑free home automation – Ask an AI to set up a “movie mode” script that dims lights, closes blinds, and turns on the TV.
- Rapid dashboard editing – Instruct Claude to add a weather card or rearrange Lovelace panels.
- Troubleshooting – Request diagnostics for a failing motion‑sensor automation; the server returns trace logs and suggested fixes.
- Bulk device control – Turn off all lights in a house with a single natural‑language command.
- System maintenance – Trigger Home Assistant updates or create a backup without opening the UI.
FAQ from the Home Assistant MCP Server
Q: Do I need a paid Claude subscription? A: No. The quick‑install guide works with a free Claude account; a paid plan is only required for higher usage limits.
Q: Which operating systems are supported?
A: macOS and Windows are officially scripted. Linux users can install via pip install ha-mcp and run the server manually.
Q: Can I use the server with other AI clients besides Claude? A: Yes. The Setup Wizard lists over 15 supported clients (Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor, etc.).
Q: Is my smart‑home data sent to the cloud? A: No. The server runs locally and only communicates with Home Assistant on your network. Telemetry is optional and anonymised.
Q: How do I enable the dev channel for early features?
A: Install the .devN package version from the releases page or follow the instructions in docs/dev-channel.md for pip/uvx, Docker, or Home Assistant add‑on installations.
Home Assistant MCP Server's README
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 | 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 →
- 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 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 | ha_search_entities, ha_deep_search, ha_get_overview, ha_get_state |
| Service & Device Control | ha_call_service, ha_bulk_control, ha_get_operation_status, ha_get_bulk_status, ha_list_services |
| Automations | ha_config_get_automation, ha_config_set_automation, ha_config_remove_automation |
| Scripts | ha_config_get_script, ha_config_set_script, ha_config_remove_script |
| Helper Entities | ha_config_list_helpers, ha_config_set_helper, ha_config_remove_helper |
| Dashboards | ha_config_get_dashboard, ha_config_set_dashboard, ha_config_update_dashboard_metadata, ha_config_delete_dashboard, ha_get_dashboard_guide, ha_get_card_types, ha_get_card_documentation |
| Areas & Floors | ha_config_list_areas, ha_config_set_area, ha_config_remove_area, ha_config_list_floors, ha_config_set_floor, ha_config_remove_floor |
| Labels | ha_config_get_label, ha_config_set_label, ha_config_remove_label, ha_manage_entity_labels |
| Zones | ha_get_zone, ha_create_zone, ha_update_zone, ha_delete_zone |
| Groups | ha_config_list_groups, ha_config_set_group, ha_config_remove_group |
| Todo Lists | ha_get_todo, ha_add_todo_item, ha_update_todo_item, ha_remove_todo_item |
| Calendar | ha_config_get_calendar_events, ha_config_set_calendar_event, ha_config_remove_calendar_event |
| Blueprints | ha_list_blueprints, ha_get_blueprint, ha_import_blueprint |
| Device Registry | ha_get_device, ha_update_device, ha_remove_device, ha_rename_entity |
| ZHA & Integrations | ha_get_zha_devices, ha_get_entity_integration_source |
| Add-ons | ha_get_addon |
| Camera | ha_get_camera_image |
| History & Statistics | ha_get_history, ha_get_statistics |
| Automation Traces | ha_get_automation_traces |
| System & Updates | ha_check_config, ha_restart, ha_reload_core, ha_get_system_info, ha_get_system_health, ha_get_updates |
| Backup & Restore | ha_backup_create, ha_backup_restore |
| Utility | ha_get_logbook, ha_eval_template, ha_get_domain_docs, ha_get_integration |
🧪 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
Home Assistant MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Home Assistant MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Activepieces
by activepieces
A self‑hosted, open‑source platform that provides a no‑code builder for creating, versioning, and running AI‑driven automation workflows. Pieces are TypeScript‑based plugins that become MCP servers, allowing direct consumption by large language models.
Skyvern
Officialby Skyvern-AI
Automates browser‑based workflows by leveraging large language models and computer‑vision techniques, turning natural‑language prompts into fully functional web interactions without writing custom scripts.
BlenderMCP
Officialby ahujasid
Enables Claude AI to control Blender for prompt‑assisted 3D modeling, scene creation, and manipulation via a socket‑based Model Context Protocol server.
Pipedream
by PipedreamHQ
Connect APIs quickly with a free, hosted integration platform that enables event‑driven automations across 1,000+ services and supports custom code in Node.js, Python, Go, or Bash.
Inbox Zero
by elie222
Organizes email inbox, drafts replies in the user's tone, tracks follow‑ups, and provides analytics to achieve inbox zero quickly.
Cursor Talk To Figma
by grab
Enables Cursor AI to read and programmatically modify Figma designs through a Model Context Protocol integration.
Windows MCP
by CursorTouch
Enables AI agents to control the Windows operating system, performing file navigation, application launching, UI interaction, QA testing, and other automation tasks through a lightweight server.
Ableton MCP
by ahujasid
Enables Claude AI to control Ableton Live in real time, allowing AI‑driven creation, editing, and playback of tracks, clips, instruments, and effects through a socket‑based server.
N8n Mcp Server
by leonardsellem
Provides tools and resources to enable AI assistants to manage and execute n8n workflows via natural language commands.