Home Assistant — MCP-сервер для Claude Code: функции и установка
MCP-сервер для Claude Code читает данные Home Assistant и вызывает его действия. Агент может проверить состояния устройств, просмотреть историю или изменить настройки дома.
MIT ★ 5 обновлён 2026-10-29
claude mcp add --env HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> --env HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> --env HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> --transport stdio home-assistant -- npx -y @foreverworks/mcp-home-assistantЧто делает Home Assistant
Сервер даёт ИИ-агенту доступ к объектам, зонам, истории и журналу Home Assistant, а также позволяет запускать действия: например, менять яркость света, температуру термостата или запускать скрипт. Действия с замками, сигнализацией, шторами и клапанами требуют отдельного подтверждения перед каждым вызовом.
Для работы нужны доступный с этой машины Home Assistant и долгосрочный токен доступа. Сервер запускается через Node 22.19 или новее и пакет @foreverworks/mcp-home-assistant; адрес задаётся в HOME_ASSISTANT_URL, путь к файлу с токеном — в HOME_ASSISTANT_TOKEN_FILE. Пользовательский токен даёт доступ ко всем инструментам, кроме render_template; административный добавляет администраторские действия.
Какие задачи решает
- посмотреть состояния устройств и их зоны
- сопоставить историю с журналом Home Assistant
- изменить яркость света или температуру термостата
- запустить сценарий с подтверждением защищённого действия
Примеры запросов агенту
- Какие устройства сейчас включены в гостиной?
- Как менялась температура в гостиной за ночь?
- Уменьши яркость кухонного света до 30 процентов.
Как установить Home Assistant
Командой платформы
claude mcp add --env HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> --env HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> --env HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> --transport stdio home-assistant -- npx -y @foreverworks/mcp-home-assistantВместо <…> подставьте свои значения
Командой платформы
codex mcp add home-assistant --env HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> --env HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> --env HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> -- npx -y @foreverworks/mcp-home-assistantВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"home-assistant": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-home-assistant"
],
"env": {
"HOME_ASSISTANT_URL": "<HOME_ASSISTANT_URL>",
"HOME_ASSISTANT_TOKEN_FILE": "<HOME_ASSISTANT_TOKEN_FILE>",
"HOME_ASSISTANT_CONFIRM_DOMAINS": "<HOME_ASSISTANT_CONFIRM_DOMAINS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"home-assistant": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-home-assistant"
],
"env": {
"HOME_ASSISTANT_URL": "<HOME_ASSISTANT_URL>",
"HOME_ASSISTANT_TOKEN_FILE": "<HOME_ASSISTANT_TOKEN_FILE>",
"HOME_ASSISTANT_CONFIRM_DOMAINS": "<HOME_ASSISTANT_CONFIRM_DOMAINS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> -e HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> -e HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> home-assistant npx -y @foreverworks/mcp-home-assistantВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Home Assistant
Как установить Home Assistant в Claude Code?
Выполни `claude mcp add home-assistant -e HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> -e HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> -- npx -y @foreverworks/mcp-home-assistant`. Укажи адрес Home Assistant и путь к файлу с долгосрочным токеном.
Что делает MCP-сервер Home Assistant?
Он передаёт агенту состояния объектов, зоны, историю и журнал, а также запускает действия Home Assistant. Для замков, сигнализации, штор и клапанов нужно подтверждать каждый вызов.
Что нужно для работы Home Assistant MCP-сервера?
Нужны доступный по сети экземпляр Home Assistant, долгосрочный токен доступа и Node 22.19 или новее. Адрес и путь к файлу токена задаются через HOME_ASSISTANT_URL и HOME_ASSISTANT_TOKEN_FILE.