# MCP Home Assistant

> Home Assistant add-on exposing an MCP server (19 tools) so AI assistants can query and control a Home Assistant instance.

Read-only by default; four guarded write tools (ha_call_service, ha_run_script, ha_trigger_automation, ha_set_automation) exist behind the allow_write option, with a two-step confirmation on sensitive domains. LAN-only design with bearer authentication. The add-on talks to Home Assistant over WebSocket through the Supervisor proxy.

## Table of Contents

- [Architecture](https://devitek.github.io/mcp-ha/reference/architecture.md)
- [Configuration](https://devitek.github.io/mcp-ha/guide/configuration.md)
- [Connecting clients](https://devitek.github.io/mcp-ha/guide/clients.md)
- [Installation](https://devitek.github.io/mcp-ha/guide/installation.md)
- [Logging](https://devitek.github.io/mcp-ha/reference/logging.md)
- [Security](https://devitek.github.io/mcp-ha/guide/security.md)
- [Tool reference](https://devitek.github.io/mcp-ha/reference/tools.md)
- [Troubleshooting](https://devitek.github.io/mcp-ha/guide/troubleshooting.md)