home-assistant-mcp — MCP-сервер для Claude Code: автоматизации Home
Связывает IDE с Home Assistant через агент-аддон: ИИ читает конфиг, собирает автоматизации, дашборды и темы, а изменения деплоит с версионированием в Git.
claude mcp add home-assistant-mcp -e HA_AGENT_URL=<HA_AGENT_URL> -e HA_AGENT_KEY=<HA_AGENT_KEY> -- npx -y @coolver/home-assistant-mcpЧто делает home-assistant-mcp
Сервер работает в паре с HA Vibecode Agent — тот ставится аддоном внутрь Home Assistant и даёт доступ к внутренним API, файлам и сервисам. Сам MCP-сервер крутится на вашем компьютере рядом с редактором и общается с агентом по API, а не через SSH. Из IDE можно прочитать сущности, автоматизации, скрипты и хелперы, собрать новые автоматизации и сенсоры под реальные устройства, переписать существующую логику, нарисовать и перестроить дашборды Lovelace, поправить темы, посмотреть логи и поставить интеграции из HACS.
Перед установкой нужен работающий Home Assistant, аддон HA Vibecode Agent v2.2.0+ и его Agent Key — он генерируется при первом запуске. Node.js должен быть на машине с редактором, а не на сервере Home Assistant: сервер запускается через npx, и на версии ниже v20.0.0 он не поедет. Без ключа и адреса агента подключаться некуда, поэтому эти два значения придётся прописать в переменных окружения.
Изменения проходят через Git-версионирование с человекочитаемыми коммитами, есть валидация конфигурации до применения и откат к прошлому состоянию. Это удобно, когда автоматизаций много и правки идут одна за другой.
Какие задачи решает
- собрать автоматизации под конкретные устройства и датчики
- переписать и объединить старые автоматизации вместо написания с нуля
- перестроить дашборд Lovelace и разложить карточки по комнатам
- настроить тему интерфейса без ручной правки YAML
- разобрать логи и найти причину сбоя автоматизации
Примеры запросов агенту
- Посмотри мой Home Assistant и собери автоматизации для климат-контроля радиаторов
- Перепиши автоматизации в
automations.yaml, объедини дублирующиеся - Добавь на дашборд карточки с графиками температуры по комнатам
Как установить home-assistant-mcp
Командой платформы
claude mcp add home-assistant-mcp -e HA_AGENT_URL=<HA_AGENT_URL> -e HA_AGENT_KEY=<HA_AGENT_KEY> -- npx -y @coolver/home-assistant-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add home-assistant-mcp --env HA_AGENT_URL=<HA_AGENT_URL> --env HA_AGENT_KEY=<HA_AGENT_KEY> -- npx -y @coolver/home-assistant-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"home-assistant-mcp": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"home-assistant-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HA_AGENT_URL=<HA_AGENT_URL> -e HA_AGENT_KEY=<HA_AGENT_KEY> home-assistant-mcp npx -y @coolver/home-assistant-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о home-assistant-mcp
Как установить home-assistant-mcp в Claude Code?
Выполните claude mcp add home-assistant-mcp -e HA_AGENT_URL=<HA_AGENT_URL> -e HA_AGENT_KEY=<HA_AGENT_KEY> -- npx -y @coolver/home-assistant-mcp. Вместо плейсхолдеров подставьте адрес агента и его ключ.
Что делает home-assistant-mcp?
Даёт ИИ-редактору доступ к вашему Home Assistant: чтение конфигурации и сущностей, создание автоматизаций, скриптов и хелперов, работа с дашбордами и темами, анализ логов и установка интеграций HACS.
Что нужно для работы home-assistant-mcp?
Запущенный Home Assistant, аддон HA Vibecode Agent v2.2.0+ с Agent Key и Node.js v20.0.0 или выше на компьютере, где стоит редактор.
