プロジェクトのスクリーンショット
概要
ha-mcp is an unofficial MCP server built with FastMCP that bridges AI assistants and Home Assistant. Unlike Home Assistant's built-in MCP server which focuses on voice-style control of exposed entities, ha-mcp provides tools for configuring, building, and maintaining the smart home. It allows AI clients to create and edit automations, scripts, dashboards, and manage system settings. The server exposes 88 tools across categories like device control, system monitoring, file management, and YAML editing, and can be run in-process via a custom component, as an add-on, via Docker, or locally via stdio.
主な機能
- 88 tools for Home Assistant interaction
- In-process server via HACS custom component with full feature parity
- Create, edit, and debug automations, scripts, and dashboards
- Read-only mode toggle and per-tool enable/disable
- Automatic edit backups and tool security policies
- Bundled Agent Skills served as MCP resources
- Optional OIDC authentication for remote access
- Beta tools for YAML and file system editing
要件、インストール、クイックスタート
使用方法
モデルの互換性とユースケース
Not stated in the repository metadata
ライセンスとリスクに関する注意事項
MIT License.
Editorial verification 2026-08-09: repository URL, owner, description, license and repository statistics were reviewed. License metadata: MIT. README was fetched for the channel draft; re-check repository dependencies, releases and model terms before production use.
リリースとメンテナンス
Breaking change in v7.3.0: `ha_config_set_yaml` moved to beta.