O que é Home Assistant MCP Server?
O Model Context Protocol Server é uma integração que vem com o Home Assistant, a plataforma de automação residencial de código aberto; a próxima vers ão da documentação a renomeia simplesmente para Model Context Protocol, para diferenciá-la da integração MCP Client, que funciona no sentido inverso. Ela chegou no Home Assistant 2025.2, tem classificação de qualidade Silver e roda dentro da sua instância no endpoint /api/mcp. As estatísticas opcionais do Home Assistant a contam em 35.284 de 707.952 instalações que enviam dados, cerca de 5%.
Ela expõe as ferramentas das LLM APIs do Home Assistant, como o controle de dispositivos do Assist, para que um modelo possa controlar dispositivos e responder perguntas sobre o estado deles. Por padrão, todas as LLM APIs ficam expostas, inclusive as adicionadas depois, e é exigida uma conta de administrador. Pelo controle de dispositivos, os clientes só podem ver e controlar as entidades expostas aos assistentes de voz. Quando a ferramenta GetLiveContext está disponível, ela também oferece um retrato somente leitura da casa como resource. Prompts, ferramentas e resources são suportados; sampling e notificações não.
Para configurar, ative o MCP em Settings > System > AI, copie a URL do servidor, adicione-a no seu cliente e entre pelo Home Assistant com OAuth 2.0. A documentação traz os passos para Claude, ChatGPT, Claude Code, Codex e OpenCode.
Como instalar Home Assistant MCP Server
https://<your-home-assistant>/api/mcpHome Assistant MCP Server vale a pena?
Como faz parte do próprio Home Assistant, não há nada extra para instalar ou corrigir; a integração recebeu commits até 18 de outubro de 2026, quando sua biblioteca MCP passou para a 2.3.0. Ela reaproveita as configurações de exposição de entidades que os assistentes de voz do Home Assistant usam, então a decisão sobre quais dispositivos o Assist pode controlar vale diretamente para o Claude ou o ChatGPT.
O login usa OAuth 2.0 com PKCE e documentos de metadados de client ID, então os clientes se registram sozinhos e não há client secret envolvido. Os padrões são mistos. A exigência de conta de administrador vem ligada, o que mantém contas casuais de fora, mas significa que a IA age com direitos de admin; a exposição de todas as LLM APIs também vem ligada, inclusive APIs adicionadas depois. Instalações anteriores a essas opções mantêm o comportamento antigo, sem exigir admin. Uma opção somente leitura, incorporada em 12 de outubro e documentada para o próximo release, limita o endpoint principal a ferramentas anotadas como somente leitura, a configuração certa para um assistente que só verifica status.
A alcançabilidade é a decisão real. O Claude se conecta a partir da nuvem da Anthropic mesmo quando você usa o Claude Desktop, e o ChatGPT na web faz o mesmo, então o Home Assistant precisa estar acessível pela internet. A assinatura Home Assistant Cloud, da Nabu Casa, a US$ 6,50 por mês ou US$ 65 por ano nos EUA, resolve isso e evita os problemas de proxy reverso e de URL do emissor que ocupam a maior parte da seção de solução de problemas. Clientes locais como Codex ou OpenCode podem usar um endereço da rede local, como homeassistant.local:8123, embora o Claude Code exija HTTPS.
O escopo é mais estreito que o de alguns servidores da comunidade, que conseguem editar automações e configuração. Este oferece o que as LLM APIs oferecem: controlar dispositivos, ler estados e gerenciar listas, não reescrever sua configuração. Clientes que exigem registro dinâmico de cliente pela RFC 7591 não conseguem se conectar, porque o Home Assistant usa metadados de client ID no lugar.
Onde ele se destaca
Um morador que já usa o Assist com 40 entidades expostas
Perguntar ao Claude se a garagem está fechada e o aquecimento desligado antes de dormir
Copie a URL My MCP, adicione-a como conector personalizado do Claude e entre; leva minutos com o Home Assistant Cloud, a US$ 6,50 por mês, fornecendo o acesso remoto. Quando for lançado, o modo somente leitura impede o assistente de mudar qualquer coisa.
Uma desenvolvedora que roda o Home Assistant em um servidor doméstico
Deixar o Codex ou o OpenCode ligar e desligar dispositivos de teste enquanto ela cria automações
Adicione http://homeassistant.local:8123/api/mcp com codex mcp add; o tráfego fica na rede local, então não é preciso acesso remoto. Exponha só as entidades de teste para que uma chamada de ferramenta errada não alcance a fechadura da porta da frente.
Um proprietário de imóveis de temporada que administra três propriedades
Verificar termostatos e fechaduras entre hóspedes pelo ChatGPT
O Home Assistant de cada propriedade precisa de acesso remoto e de seu próprio conector. Selecione as entidades expostas por propriedade e considere uma conta sem admin, já que um agente capaz de destrancar portas é uma decisão de segurança, não de conveniência.
Antes de decidir
- Configuração
- Ative o MCP em Settings > System > AI, copie a URL do servidor (o Home Assistant recomenda My MCP), adicione-a no cliente e entre via OAuth. Clientes na nuvem também precisam de acesso remoto pelo Home Assistant Cloud ou por um proxy próprio.
- Integrações
- As ferramentas são as que as LLM APIs selecionadas fornecem, principalmente o controle de dispositivos do Assist, além de prompts e um resource homeassistant://assist/context-snapshot. Endpoints por API, como /api/mcp/assist, ficam ao lado de /api/mcp. Clientes documentados: Claude, ChatGPT, Claude Code, Codex e OpenCode.
- Dados e privacidade
- O cliente pode ler e controlar toda entidade exposta com os direitos do usuário que fez login. O servidor roda na sua instância, mas, com clientes na nuvem, nomes e estados das entidades passam pelo provedor de IA. O texto que as pessoas digitam no Home Assistant, como itens de tarefas, chega ao modelo como está.
- Custo em escala
- Gratuito com o Home Assistant. O acesso remoto pela Nabu Casa custa US$ 6,50 por mês ou US$ 65 por ano nos EUA (£ 6,50 por mês com impostos no Reino Unido); a assinatura do próprio cliente de IA é à parte.
- Limites
- Sem sampling, notificações nem registro dinâmico pela RFC 7591. Divergências de hostname ou de cabeçalhos encaminhados quebram a descoberta OAuth atrás de túneis e proxies. A futura opção somente leitura cobre só /api/mcp, não os endpoints por API.
O que é bom
- Vem com o Home Assistant, sem processo extra
- OAuth 2.0 com PKCE; sem client secret
- Respeita as configurações de exposição de entidades do Assist
- Opção somente leitura documentada para o próximo release
O que não é
- Clientes na nuvem, inclusive o Claude Desktop, exigem sua instância na internet
- Expõe todas as LLM APIs com direitos de admin por padrão
- Sem registro dinâmico de cliente, sampling nem notificações
Ideal para
Usuários do Home Assistant que querem que o Claude ou outro assistente verifique e controle seus dispositivos sob as próprias permissões do Home Assistant.
Alternativas ao Home Assistant MCP Server
Home Assistant MCP Server: perguntas frequentes
- Home Assistant MCP Server vale a pena?
- Embutida no Home Assistant e sujeita às próprias configurações de exposição dele, esta é a forma mais segura de deixar um assistente chegar perto das suas fechaduras, depois que você restringe o que ele pode ver. Damos nota 4.3 de 5.
- Quanto custa Home Assistant MCP Server?
- Gratuito; incluído no Home Assistant (Apache 2.0). Clientes na nuvem precisam de acesso remoto, pelo Home Assistant Cloud ou por uma configuração própria.
- Quais são as desvantagens de Home Assistant MCP Server?
- Clientes na nuvem, inclusive o Claude Desktop, exigem sua instância na internet; expõe todas as LLM APIs com direitos de admin por padrão; sem registro dinâmico de cliente, sampling nem notificações.
- Para quem Home Assistant MCP Server é indicado?
- Usuários do Home Assistant que querem que o Claude ou outro assistente verifique e controle seus dispositivos sob as próprias permissões do Home Assistant.
- Quanto custa Home Assistant MCP Server para uma equipe ou em produção?
- Gratuito com o Home Assistant. O acesso remoto pela Nabu Casa custa US$ 6,50 por mês ou US$ 65 por ano nos EUA (£ 6,50 por mês com impostos no Reino Unido); a assinatura do próprio cliente de IA é à parte.
- Home Assistant MCP Server é seguro para dados da empresa?
- O cliente pode ler e controlar toda entidade exposta com os direitos do usuário que fez login. O servidor roda na sua instância, mas, com clientes na nuvem, nomes e estados das entidades passam pelo provedor de IA. O texto que as pessoas digitam no Home Assistant, como itens de tarefas, chega ao modelo como está.
- Quais são as melhores alternativas ao Home Assistant MCP Server?
- As alternativas mais próximas que analisamos são Google Workspace MCP servers e Zapier MCP.
Respostas verificadas em 22 de out. de 2026.