Hass-MCP

MCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/hass-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'HA_URL=<значение HA_URL>' --env 'HA_TOKEN=<ваш HA_TOKEN>' hass-mcp -- docker run -i --rm -e HA_URL -e HA_TOKEN voska/hass-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"hass-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","-e","HA_URL","-e","HA_TOKEN","voska/hass-mcp"],"env":{"HA_URL":"<значение HA_URL>","HA_TOKEN":"<ваш HA_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "hass-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add hass-mcp --env 'HA_URL=<значение HA_URL>' --env 'HA_TOKEN=<ваш HA_TOKEN>' -- docker run -i --rm -e HA_URL -e HA_TOKEN voska/hass-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.hass-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "HA_URL", "-e", "HA_TOKEN", "voska/hass-mcp"]
env = { HA_URL = "<значение HA_URL>", HA_TOKEN = "<ваш HA_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "hass-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "environment": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "<значение HA_URL>",
        "HA_TOKEN": "<ваш HA_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HA_URLобязательная
HA_TOKENсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Docker

Сверено с репозиторием 25 сент. 2026, коммит e05bfde.

Текст для агента

Добавь в конфигурацию MCP-клиента сервер hass-mcp: command uvx, args hass-mcp, в env задай HA_URL с адресом Home Assistant и HA_TOKEN с долгоживущим токеном. Как альтернатива есть Docker-образ voska/hass-mcp.

Другие способы из описания автора

uvx hass-mcp

Перед запуском задайте HA_URL и HA_TOKEN в переменных окружения. Нужен Python 3.13 и uv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер связывает агента с вашим экземпляром Home Assistant. Он читает состояние устройств и датчиков, ищет сущности, включает и выключает свет и приборы, вызывает любые сервисы и перезапускает Home Assistant. Есть история и долгосрочная статистика по сущностям, чтение журнала ошибок и живое редактирование дашбордов Lovelace через WebSocket с автоматическими резервными копиями. В комплекте готовые сценарии-подсказки для создания и отладки автоматизаций.

Для кого. Для владельцев умного дома на Home Assistant, кто хочет управлять им и настраивать через агента.

Подходит, если

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

Не подходит, если

Нет своего экземпляра Home Assistant с долгоживущим токеном
Нельзя доверять клиенту полный контроль над домом и устройствами

Пример запроса к агенту

Какая температура в спальне и выключи свет на кухне

Ограничения

Нужен экземпляр Home Assistant с долгоживущим токеном, а для правки дашбордов Lovelace токен должен принадлежать администратору и работать только с UI-дашбордами в режиме storage. Запуск через Docker-образ voska/hass-mcp или через uvx с пакетом hass-mcp, нужен Python 3.13 и uv. Режим http открывает полный доступ к дому по сети без встроенной авторизации, поэтому его нельзя выставлять в интернет без обратного прокси или VPN.

Как отключить. Удалите блок hass-mcp из конфигурации MCP-клиента и перезапустите его. При запуске в Docker остановите и удалите контейнер, при необходимости отзовите долгоживущий токен в Home Assistant.

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения
Переменные окружения
HA_URL обязательная	Адрес вашего экземпляра Home Assistant
HA_TOKEN обязательная, секрет	Долгоживущий токен доступа Home Assistant
SSL_CERT_FILE	Путь к корневому сертификату своего центра сертификации

Проверка безопасности

Управляет реальными устройствами дома, включая свет, приборы и замки
Может перезапускать Home Assistant и вызывать любые его сервисы
Правит дашборды и работает с долгоживущим токеном доступа

Коротко о README

README описывает установку через Docker-образ voska/hass-mcp и через uvx с пакетом hass-mcp, настройку для Claude Desktop, Cursor и Claude Code с переменными HA_URL и HA_TOKEN. Перечислены инструменты для состояния и поиска сущностей, действий над ними, вызова сервисов, перезапуска, истории и статистики, журнала ошибок и живого редактирования дашбордов Lovelace с резервными копиями. Отдельно показан транспорт streamable http с предупреждением о безопасности и настройка своего центра сертификации. Есть готовые сценарии-подсказки и ресурсы, лицензия MIT.

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

Какой токен нужен?

Долгоживущий токен доступа из профиля Home Assistant. Для правки дашбордов Lovelace токен должен принадлежать администратору.

Безопасен ли режим http?

Он открывает полное управление домом по сети без встроенной авторизации. Его нужно закрывать обратным прокси, VPN или привязкой только к localhost и не выставлять в интернет.

n8n-MCP

Выбор редакции

MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n

MCP-серверВысокий рискБез VPN23 тыс.

Zapier MCP

Официальный

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинВысокий риск421

Awesome Claude Skills от Composio

Awesome Claude Skills

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75,8 тыс.

CLI-Anything

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинВысокий рискБез VPN50,9 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

n8n-MCP

Zapier MCP

Awesome Claude Skills от Composio

CLI-Anything