Ha MCP Server

Home Assistant smart home devices, state queries, and automation control for AI agents.

Data last scanned today · Reviewed today

50 17 dangerous tools95 tools★ 4,135PythonMIT

Overview

This Python-based MCP server provides comprehensive integration between AI assistants and Home Assistant. It supports a vast range of over 80 tools that allow users to interact with smart home devices, monitor system states, and trigger automations using natural language commands. The server is designed for flexible deployment, with the recommended installation method being the HA-MCP Custom Component via HACS. This in-process approach ensures full feature parity across all Home Assistant installation types, including Home Assistant OS, Supervised, Container, and Core, while removing the need for manual access token management.

Our verdict

With a security score of 50/100, this server carries a high risk level. This assessment is largely due to the project being community-maintained rather than developed by the official Home Assistant vendor, meaning it lacks official security oversight. Additionally, critical security components like authentication methods and read-only mode implementations have not yet undergone formal review. It is best suited for advanced users who understand the risks of integrating third-party community code with their smart home infrastructure.

Supports over 80 distinct Home Assistant tools.
Zero direct dependencies simplifies the supply-chain surface.
Maintains an active development cycle with daily commits.
Large contributor base of 57 individuals.

Lacks official vendor support or maintenance.
Authentication methods remain unreviewed.
Read-only capabilities have not been formally verified.

Tools

Tool	Description	Risk
ha_get_addon	Get information about a Home Assistant add-on	low
ha_manage_addon	Manage a Home Assistant add-on	medium
ha_list_floors_areas	List floors and areas in Home Assistant	low
ha_remove_area_or_floor	Remove an area or floor	high
ha_set_area_or_floor	Create or update an area or floor	medium
ha_manage_pipeline	Manage Assist pipelines	medium
ha_config_get_automation	Get details of an automation	low
ha_config_remove_automation	Remove an automation	high
ha_config_set_automation	Create or update an automation	medium
ha_get_blueprint	Get information about a blueprint	low

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What is the recommended installation method?

The recommended method is the HA-MCP Custom Component via HACS, which installs the server in-process and works across all Home Assistant installation types.

›Can I run the in-process server alongside other installation methods?

No, you should only run one instance of the server; you must not run the in-process server alongside an add-on, Docker, or stdio install.

›How can I restrict the server to local access only?

You can turn off the 'Remote access via webhook' option in the integration settings to ensure no webhook is registered.

›Does the server require authentication for webhooks?

By default, the webhook uses a secret URL, but you can set 'Webhook authentication' to 'ha_auth' to require a Home Assistant account sign-in.

›When should I use the HA-MCP File & YAML Tools entry?

This secondary integration entry is only required if you explicitly enable the opt-in file and YAML editing tools, which are disabled by default.

›Has the functionality of any tools recently changed?

Yes, as of version 7.3.0, the 'ha_config_set_yaml' tool has been moved to beta status.

Changelog

Improved
Dev Build 7.14.2.dev2146
2026-07-27
Improved
Dev Build 7.14.2.dev2142
2026-07-27
Improved
Dev Build 7.14.2.dev2139
2026-07-27
Improved
Dev Build 7.14.2.dev2136
2026-07-26
Improved
Dev Build 7.14.2.dev2135
2026-07-26
Fix
v7.14.2
2026-07-22
Fix
v7.14.1
2026-07-19
Fix
v7.14.0
2026-07-19
Fix
v7.13.0
2026-07-16
Fix
🚨 Hotfix v7.12.3
2026-07-10

Badge

Maintain this server? Add the live badge to your README.