homeassistant-mcp
MCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
- 576 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Токен Home Assistant открывает управление замками, камерами, климатом и всеми остальными устройствами дома
- Инструменты устанавливают и удаляют дополнения и пакеты HACS и меняют автоматизации в рабочей конфигурации
- HTTP-интерфейс на порту 3000 открывает управление домом сетевым клиентам, пока вы не ограничите доступ к порту
Установка
- Работает в
Ручная установка
git clone https://github.com/tevonsb/homeassistant-mcp.git && cd homeassistant-mcp && cp .env.example .env && docker compose up -dРекомендуемый способ через Docker Compose. Перед запуском впишите в .env адрес Home Assistant и токен. Проверка: http://localhost:3000/health.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен Home Assistant открывает управление замками, камерами, климатом и всеми остальными устройствами дома
- Инструменты устанавливают и удаляют дополнения и пакеты HACS и меняют автоматизации в рабочей конфигурации
- HTTP-интерфейс на порту 3000 открывает управление домом сетевым клиентам, пока вы не ограничите доступ к порту
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер соединяет ваш экземпляр Home Assistant с агентом по протоколу MCP. По запросу на естественном языке агент включает свет и меняет его яркость и цвет, задает температуру и режим климата, двигает шторы. Еще он управляет замками, пылесосами и медиаплеерами, а состояния датчиков и камер читает. Отдельные инструменты работают с самой системой. `addon` ставит и удаляет дополнения, запускает и перезапускает их. `package` ставит из каталога HACS интеграции, темы и скрипты Python, а также приложения AppDaemon и NetDaemon. `automation_config` создает, правит и дублирует автоматизации с триггерами, условиями и действиями. Рядом с MCP сервер поднимает HTTP-интерфейс с проверкой токена и лимитом частоты запросов.
Для кого. Для владельцев Home Assistant, которые хотят управлять домом и настройками системы через Claude Desktop или другой MCP-клиент.
Подходит, если
- Нужно сказать агенту «включи свет в гостиной на половину яркости» и увидеть, что команда выполнена
- Нужно, чтобы агент собрал автоматизацию: например, свет по датчику движения, с триггером, условиями и действиями
- Нужно следить за изменениями состояния устройств в реальном времени через поток событий
- Нужно обращаться к устройствам по комнатам и этажам, в которые они сгруппированы
Не подходит, если
- Нет Home Assistant: сервер работает только с его API и ничего не умеет с другими системами умного дома
- Токен Home Assistant хранится небезопасно или экземпляр открыт из интернета: утечка токена дает посторонним полный доступ к дому через сервер
- Нужна изолированная проверка автоматизации без угрозы для реальных устройств: инструмент меняет рабочую конфигурацию
Пример запроса к агенту
Включи свет в гостиной на 50 процентов яркости и создай автоматизацию: когда датчик движения в коридоре срабатывает, зажигать свет в коридоре.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
HASS_HOSTобязательная- Адрес экземпляра Home Assistant, например http://homeassistant.local:8123.
HASS_TOKENобязательная, секрет- Долгоживущий токен доступа Home Assistant.
HASS_SOCKET_URLобязательная- Адрес WebSocket Home Assistant, например ws://homeassistant.local:8123/api/websocket.
PORT- Порт HTTP-сервера, по умолчанию 3000.
DEBUG- Режим отладки, значения true или false.
Ограничения
Нужны Node.js 20.10.0 или новее, работающий Home Assistant и долгоживущий токен доступа. Для управления дополнениями нужен доступ к Supervisor, для пакетов — установленный HACS. Docker-вариант запускает сервер отдельной службой, и внутри Claude Desktop он не работает. Канал WebSocket для обновлений в реальном времени автор документирует, но в статусе проекта он числится незавершенным. Там же в работе усиление защиты и расширение тестов. Последний коммит сделан в январе 2026 года.
Как отключить. Остановите контейнеры командой `docker compose down` или уберите блок `homeassistant` из конфигурации Claude Desktop. Затем отзовите долгоживущий токен в профиле пользователя Home Assistant: пока токен действует, любой запущенный сервер с ним сохраняет доступ к дому.
Частые вопросы
Как подключить homeassistant-mcp к Claude Desktop?
Соберите проект командами `npm install` и `npm run build`. Затем добавьте в конфигурацию клиента блок `homeassistant` с командой `node`, путем к собранной папке `dist` и переменными `HASS_HOST`, `HASS_TOKEN`, `HASS_SOCKET_URL`.
Где взять токен для Home Assistant?
Долгоживущий токен создают в профиле пользователя Home Assistant и вписывают в переменную `HASS_TOKEN` файла `.env`. Заведите для сервера отдельный токен, тогда его можно отозвать, не трогая другие интеграции.
Можно ли получать события устройств в реальном времени?
Да. Сервер отдает поток Server-Sent Events по адресу `/subscribe_events` с токеном в параметре и фильтром по домену или устройству, например `domain=light`. Формат событий разобран в файле `docs/SSE_API.md`.
Какие ограничения на частоту запросов?
Обычные конечные точки принимают 100 запросов в минуту с одного IP-адреса. При превышении сервер возвращает ошибку `RATE_LIMIT_EXCEEDED` с временем сброса лимита.
Что делать при ошибке `toSorted is not a function`?
Обновите Node.js, например командами `nvm install 20.10.0` и `nvm use 20.10.0`. Более ранние версии не поддерживают этот метод.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Home Assistant: агент читает состояние умного дома и управляет устройствами через ваш экземпляр
MCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома
Home Assistant Vibecode Agent
home-assistant-vibecode-agent
Надстройка Home Assistant и сервер MCP: агент проверяет конфигурацию и применяет автоматизации. Нужен долгоживущий токен. Не официальный проект
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
MCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| homeassistant-mcp (эта запись) | нет | API-ключ | 576 | |
| ha-mcp | нет | API-ключ | 5 333 | MCP-сервер, который ведет в экземпляр Home Assistant и читает состояние дома, а этот добавляет управление дополнениями и пакетами HACS |
| Hass-MCP | нет | API-ключ | 351 | MCP-сервер на Python: читает состояние устройств, управляет ими и правит дашборды |
| Home Assistant Vibecode Agent | нет | API-ключ | 647 | надстройка Home Assistant, где агент проверяет конфигурацию и применяет автоматизации |
Коротко о README
Страница проекта открывается списком устройств и возможностей, потом ведет через установку в Docker или из исходников и настройку переменных окружения. Основной объем занимает справочник инструментов с примерами запросов. В конце собраны частые ошибки, лимиты и статус работ.