Этот аддон Home Assistant предоставляет сервер MCP (Model Context Protocol). На практике: вы подключаете Claude, Gemini или любой другой MCP-клиент к своему экземпляру и общаетесь со своим домом.
«Какие лампы остались включёнными?», «Почему автоматизация отопления не сработала прошлой ночью?», «Построй график моего энергопотребления за неделю».
Документация: devitek.github.io/mcp-ha (на английском и французском)
Домен | Инструменты |
Сущности, зоны, устройства | нечёткий поиск, постраничные списки, полные детали |
Сервисы | каталог по доменам, поиск, защищённый вызов (по желанию) |
Автоматизации | список, состояние, последний триггер, полная конфигурация |
Скрипты | список, состояние выполнения |
История | изменения состояний, долгосрочная статистика, журнал |
Аддоны | список и детали (чтение) |
Система | рендеринг шаблонов Jinja, конфигурация HA, журнал ошибок |
Всего 16 инструментов, разработанных для экономии контекстного окна LLM: компактные, постраничные и ограниченные ответы, с примечаниями, направляющими ассистента к более точным запросам.
Related MCP server: hass-mcp
Она существует и работает, но идёт через Assist API: только сущности, доступные для Assist, без истории, без реестров, без аддонов, без конфигураций автоматизаций. Этот аддон даёт прямой, детальный доступ. Оба могут сосуществовать.
Требования: Home Assistant OS или Supervised (аддону нужен Supervisor).
Добавьте этот репозиторий в репозитории аддонов:
Или вручную: Настройки, Аддоны, Магазин аддонов, меню из трёх точек, Репозитории, затем вставьте https://github.com/Devitek/mcp-ha.
Установите «MCP Home Assistant» и запустите его.
Откройте вкладку «Конфигурация» аддона: при первом запуске там был создан и сохранён токен API (он также выводится в журнале аддона).
Claude Code:
claude mcp add --transport http home-assistant \
http://HA_IP:9583/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Claude Desktop и Gemini CLI: см. руководство по клиентам на сайте документации.
По умолчанию только чтение. Инструмент вызова сервисов даже не существует для клиента, если вы не включите allow_write.
Многоуровневая защита при включённой записи: денлист опасных сервисов (HA shutdown, shell_command...), глобальные списки разрешений/запретов для сущностей, режим dry_run, JSON-журнал аудита каждой попытки в журнале.
Только локальная сеть. Нет TLS, нет OAuth: не открывайте порт 9583 в интернет.
Полная модель угроз описана в SECURITY.md.
Сайт документации: установка, конфигурация, клиенты, справочник инструментов, архитектура (английский и французский)
Документация аддона: страница, отображаемая в интерфейсе HA
Руководство по внесению вклада: настройка разработки, соглашения, релизы
Проблемы репозитория: база знаний проекта, каждое проектное решение и подводный камень отслеживаются там с метками décision и écueil (на французском)
This server cannot be deployed
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud