// agents · homeassistant-ai/ha-mcp

ha-mcp

ha-mcp é um projeto de agentes de IA de código aberto de homeassistant-ai (homeassistant-ai/ha-mcp no GitHub). Tem 4.977 estrelas no GitHub e 231 forks, é publicado sob a licença MIT e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

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

★ 5,0 mil estrelas⑂ 231 forksMITatualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Estrelas no GitHub
4.977
Forks
231
Licença
MIT
Última atualização no GitHub
8 de outubro de 2026
Categoria
Agentes de IA
Tipo de ficha
Guia de instalação completo
Site oficial
Official site
// como funciona

Como funciona

  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.

// recursos

Por que as pessoas gostam tanto

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
// execute você mesmo

Execute você mesmo

  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
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

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.

// continue explorando

Ferramentas semelhantes

Agentes de IA

google_workspace_mcp

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

★ 3,3 mil estrelasMIT
Ver o guia →
Agentes de IA

deep-research

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

★ 4,7 mil estrelasMIT
Ver o guia →
Agentes de IA

lamda

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

★ 8,6 mil estrelasMIT
Ver o guia →
Agentes de IA

mcp

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

★ 789 estrelasMIT
Ver o guia →
Agentes de IA

github-mcp-server

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

★ 33,4 mil estrelasMIT
Ver o guia →
Agentes de IA

ouroboros

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

★ 6,2 mil estrelasMIT
Ver o guia →
// alternativas

Alternativas em Agentes de IA

Os outros projetos de Agentes de IA com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se ha-mcp não for o ideal para você.

// mais em agents

Mais em Agentes de IA

Projetos de Agentes de IA próximos no catálogo, os mais próximos em estrelas de ha-mcp: continue explorando dos dois lados dele.

Baixe o ha-mcp

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.