Home Assistant MCP

homeassistant-ai/ha-mcp· Проверено 12.11.2026· 7,6 тыс.на GitHub

Даёт агенту управление и настройку Home Assistant: создавать и править автоматизации, скрипты и дашборды, разбирать по трассировкам, почему автоматизация не сработала, управлять устройствами.

Как подключить

Что сделать до подключения

1

Home Assistant 2026.8.0 или новее

2

Установите интеграцию HA-MCP: на 2026.8–2026.10 через HACS (поиск HA-MCP → Download), на 2026.11 и новее через Settings → Marketplace

3

Перезапустите Home Assistant

4

Settings → Devices & Services → Add Integration → HA-MCP Server: вставьте долгоживущий токен администратора (профиль → Security → Long-lived access tokens) и выберите способ подключения клиентов

5

Скопируйте адрес подключения на экране Configure этой интеграции и вставьте его в клиент

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http home-assistant http://<ha-host>:8123/api/webhook/<webhook-id>

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

ha_searchищет сущности и настройки
ha_get_overviewпоказывает обзор системы
ha_get_stateпоказывает состояние сущности
ha_call_serviceвызывает сервис
ha_bulk_controlуправляет группой устройств
ha_config_get_automationчитает автоматизацию
ha_config_set_automationсоздаёт и правит автоматизацию
ha_get_automation_tracesпоказывает трассировки автоматизаций
ha_config_set_scriptсоздаёт и правит скрипт
ha_config_set_sceneсоздаёт и правит сцену
ha_config_get_dashboardчитает дашборд
ha_config_set_dashboardправит дашборд
ha_config_set_helperсоздаёт вспомогательную сущность
ha_get_historyпоказывает историю
ha_get_logsчитает логи
ha_get_camera_imageснимает кадр с камеры
ha_manage_backupуправляет резервными копиями
ha_manage_hacsуправляет HACS
ha_eval_templateпроверяет шаблон
ha_restartперезапускает Home Assistant

Показано 20 из 87.

Что попросить агента

«Создай автоматизацию: на закате включать свет на крыльце»Найдёт светильник через ha_search и создаст автоматизацию с триггером и действием через ha_config_set_automation
«Добавь на мой дашборд карточку погоды»Прочитает дашборд через ha_config_get_dashboard и сохранит его с новой карточкой через ha_config_set_dashboard
«Автоматизация с датчиком движения не срабатывает, разберись»Прочитает её через ha_config_get_automation, изучит трассировки запусков через ha_get_automation_traces и предложит исправление
«Пусть утренняя автоматизация ещё и включает кофеварку»Прочитает текущую автоматизацию через ha_config_get_automation, добавит действие и обновит её через ha_config_set_automation
«Сделай скрипт «режим кино»: приглушить свет, закрыть шторы, включить телевизор»Создаст скрипт с последовательностью действий через ha_config_set_script

Для каких задач

Создать автоматизацию словами, например включать свет на крыльце на закате
Найти по трассировкам, почему автоматизация с датчиком движения не срабатывает
Добавить карточку погоды на дашборд
Собрать скрипт «режим кино»: приглушить свет, закрыть шторы, включить телевизор
Сделать резервную копию и поставить обновления

Ограничения

!

Агент действует от имени администратора, чей токен вы дали: ему доступно всё в Home Assistant, включая перезапуск и удаление

!

Интеграция требует Home Assistant 2026.8.0 или новее; для запуска вне Home Assistant есть образ Docker и пакет для uvx

!

Запуск через stdio работает с ошибками соединения; для постоянной работы нужен HTTP

!

Инструменты для файлов и YAML выключены по умолчанию и включаются флагами функций

Если не работает

Ошибка uvx not found
После установки uv перезапустите терминал или Claude Desktop. Claude Desktop не наследует PATH оболочки: впишите в command полный путь к uvx, его покажет which uvx или where uvx.
Token invalid или другие ошибки авторизации
Создайте новый долгоживущий токен: профиль в Home Assistant → вкладка Security → Long-lived access tokens; в конфиге не берите токен в кавычки и используйте токен администратора.
Claude Desktop показывает сервер подключённым, но инструментов ноль
Уберите скобки из имени сервера в claude_desktop_config.json, например «Home Assistant (ha-mcp)» замените на «HASS ha-mcp», и перезапустите клиент.
Новые инструменты не появляются или падают с Unknown tool
Клиент держит старый список инструментов: обновите сервер в настройках клиента или переподключите его и начните новый диалог; перезапуск Home Assistant список не обновляет.
Соединение зависает
Оставьте в клиенте один способ подключения: две записи для одного сервера, например локальный uvx и адрес приложения, приводят к зависаниям.

Частые вопросы

Чем ha-mcp отличается от встроенного MCP Server в Home Assistant?
Встроенный сервер работает через Assist и видит только открытые для него сущности. ha-mcp видит всё и ещё умеет создавать автоматизации, скрипты, сцены, дашборды и разбирать трассировки.
Как дать агенту доступ только на чтение?
Допишите /readonly к адресу подключения, например …/api/webhook/<webhook-id>/readonly. Инструменты записи скроются, остальные клиенты сохранят обычный доступ.
Можно ли попробовать без своего Home Assistant?
Да, есть демо-сервер: скрипты для Windows, macOS и Linux подключают клиент через stdio к готовой демо-среде, подписка не нужна.
Как подключиться из дома без выхода в интернет?
Не включайте удалённый доступ при настройке. Клиенты в той же сети подключаются напрямую по адресу http://<ip-адрес>:9584/private_<код>.
Работает ли сервер из России?
Сервер работает внутри вашего Home Assistant, данные умного дома остаются в вашей сети; для доступа извне нужен Nabu Casa или свой обратный прокси.

Похожие серверы