
Home Assistant MCP
Даёт агенту управление и настройку Home Assistant: создавать и править автоматизации, скрипты и дашборды, разбирать по трассировкам, почему автоматизация не сработала, управлять устройствами.
Как подключить
Что сделать до подключения
Home Assistant 2026.8.0 или новее
Установите интеграцию HA-MCP: на 2026.8–2026.10 через HACS (поиск HA-MCP → Download), на 2026.11 и новее через Settings → Marketplace
Перезапустите Home Assistant
Settings → Devices & Services → Add Integration → HA-MCP Server: вставьте долгоживущий токен администратора (профиль → Security → Long-lived access tokens) и выберите способ подключения клиентов
Скопируйте адрес подключения на экране 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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.home-assistant]
url = "http://<ha-host>:8123/api/webhook/<webhook-id>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"home-assistant": {
"url": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"home-assistant": {
"type": "http",
"url": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"home-assistant": {
"httpUrl": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"home-assistant": {
"httpUrl": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"home-assistant": {
"type": "remote",
"url": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://<ha-host>:8123/api/webhook/<webhook-id>Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"home-assistant": {
"url": "http://<ha-host>:8123/api/webhook/<webhook-id>"
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
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управляет HACSha_eval_templateпроверяет шаблонha_restartперезапускает Home AssistantПоказано 20 из 87.
Что попросить агента
Для каких задач
Ограничения
Агент действует от имени администратора, чей токен вы дали: ему доступно всё в Home Assistant, включая перезапуск и удаление
Интеграция требует Home Assistant 2026.8.0 или новее; для запуска вне Home Assistant есть образ Docker и пакет для uvx
Запуск через stdio работает с ошибками соединения; для постоянной работы нужен HTTP
Инструменты для файлов и YAML выключены по умолчанию и включаются флагами функций