// agents · homeassistant-ai/ha-mcp

ha-mcp

ha-mcp — проект с открытым исходным кодом из категории «ИИ-агенты» от homeassistant-ai (homeassistant-ai/ha-mcp на GitHub). У него 4 977 звёзд на GitHub и 231 форк, он распространяется по лицензии MIT и последний раз обновлялся на GitHub 8 октября 2026.

The unofficial Home Assistant MCP server — control and automate your smart home from any AI assistant.

★ 5,0 тыс. звёзд⑂ 231 форкMITобновлено окт. 2026
▦ визуал — в README этого проекта нет встраиваемого скриншота,
поэтому здесь заглушка. Руководство ниже в любом случае полное.
// факты о проекте

Факты о проекте

Репозиторий
homeassistant-ai/ha-mcp
Звёзды GitHub
4 977
Форки
231
Лицензия
MIT
Последнее обновление на GitHub
8 октября 2026
Категория
ИИ-агенты
Тип страницы
Полное руководство по установке
Официальный сайт
Official site
// как это работает

Как это работает

  1. Clarify what your assistant should do

    Decide which parts of your home the assistant may see and control, and which client (Claude or another MCP client) you will use.

  2. Choose an install method

    Pick one: the in-process HACS integration, the Docker HTTP server, or the uvx/PyPI server — running more than one is not supported.

  3. Connect to Home Assistant

    Point the server at your Home Assistant URL with a long-lived access token (an administrator's is recommended), or finish the in-app setup.

  4. Ask your first command

    Ask your assistant about your home — list lights, check a sensor, run a script — through the MCP tools.

// возможности

Почему его любят

Full MCP access to Home Assistant

Exposes your Home Assistant entities and services as MCP tools so assistants can read state and take action.

In-process integration option

Can run inside Home Assistant itself via HACS, replacing the other install methods, with an admin-only HA-MCP settings panel in the sidebar.

Remote access via webhook

A Nabu Casa remote webhook URL lets cloud MCP clients reach your home securely; local-only mode disables the webhook entirely.

Flexible authentication

Options include the secret URL as credential, Home Assistant account sign-in (ha_auth), or OIDC via an external identity provider such as Authentik, Keycloak or Auth0.

Tool search for small contexts

An optional ENABLE_TOOL_SEARCH mode defers the large tool catalog behind a search interface so models with small context windows (or capped clients) can still work.

Docker and PyPI servers

Run ghcr.io/homeassistant-ai/ha-mcp as an HTTP server, or the published ha-mcp package with uvx, pointed at your Home Assistant.

Advertisement
// запустите сами

Запустите сами

  1. Clone the repository

    Clone ha-mcp if you want the source or the manual integration files.

    git clone https://github.com/homeassistant-ai/ha-mcp.git
    cd ha-mcp
  2. Install with the one-command installer

    Run the installer for your OS and MCP client — this example wires up Claude Code on Linux.

    curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-linux.sh | sh
    # For Claude Code: curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install.sh | sh -s -- --claude-code
  3. Or run the server package

    Alternatively, serve ha-mcp over HTTP with uvx against your Home Assistant instance.

    uvx ha-mcp@latest # see README for the exact command
// сценарии использования

Что можно создать

Advertisement
// вопросы и ответы

Вопросы и ответы

Who maintains ha-mcp?

ha-mcp is a community project from homeassistant-ai; it is unofficial and not affiliated with the Home Assistant project itself.

Is ha-mcp free?

Yes — it is open source under the MIT license. You need your own Home Assistant instance (also free and open source).

Does it need a paid API key?

No API key is required; the server authenticates to your Home Assistant with a long-lived access token you create. Remote access can use your Nabu Casa account if you have one.

How does it compare to Home Assistant's built-in Assist or LLM integrations?

Those live inside Home Assistant's own conversation features; ha-mcp exposes your home to external MCP clients and agents (Claude and others) with fine-grained install and auth options.

How do I get started?

Pick one install method — HACS integration is the most integrated — run the installer or add the integration, and connect your MCP client.

// продолжить изучение

Похожие инструменты

ИИ-агенты

google_workspace_mcp

Control Gmail, Calendar, Docs, Sheets, Drive and more from AI — a full Google Workspace MCP server.

★ 3,3 тыс. звёздMIT
Смотреть руководство →
ИИ-агенты

deep-research

Deep Research with any LLM: in-depth reports in minutes, with an SSE API and MCP server built in

★ 4,7 тыс. звёздMIT
Смотреть руководство →
ИИ-агенты

lamda

FIRERPA / LAMDA — full-stack Android device control: remote desktop, automation, MITM, Frida and MCP.

★ 8,6 тыс. звёздMIT
Смотреть руководство →
ИИ-агенты

mcp

An MCP server that puts Hyperbrowser's browsers behind the protocol.

★ 789 звёздMIT
Смотреть руководство →
ИИ-агенты

github-mcp-server

GitHub's official MCP server — let AI tools work with repos, issues and pull requests

★ 33,4 тыс. звёздMIT
Смотреть руководство →
ИИ-агенты

ouroboros

An Agent OS with interview-gated, budgeted evolution — one MCP server across 14 agent runtimes.

★ 6,2 тыс. звёздMIT
Смотреть руководство →
// альтернативы

Альтернативы: ИИ-агенты

Другие проекты из категории «ИИ-агенты» с наибольшим числом звёзд в каталоге LibreAI — реалистичный список альтернатив, если ha-mcp вам не подходит.

// ещё в категории agents

Больше проектов: ИИ-агенты

Соседние проекты из категории «ИИ-агенты» в каталоге, ближайшие по числу звёзд к ha-mcp — продолжайте изучать полку по обе стороны от него.

Получить ha-mcp

Бесплатно и открыто — забирайте исходный код, ставьте звезду репозиторию и начинайте создавать.