ha-mcp liga Claude e ChatGPT ao Home Assistant para criar e controlar automações

O ha-mcp, repositório de código aberto da organização homeassistant-ai, conecta assistentes de IA como Claude e ChatGPT ao Home Assistant por meio do Model Context Protocol (MCP). Está em alta no GitHub, com 640 estrelas ganhas hoje e 7.313 no total. A proposta é permitir que o usuário peça em linguagem natural a criação de automações, scripts e outras configurações.

O que é e o que faz

O ha-mcp é um servidor MCP para o Home Assistant. Segundo o projeto, o usuário conversa com o assistente de IA e pede, por exemplo, uma automação que acenda a luz da varanda ao pôr do sol, ou um script de modo cinema que reduza as luzes, feche as persianas e ligue a TV.

O site do projeto lista recursos de busca (entidades com correspondência aproximada e busca profunda em configurações), controle de serviços e dispositivos em lote, e gerenciamento de automações, scripts, helpers, painéis, áreas, zonas e grupos. Também cita backup e restauração, atualizações e registro de dispositivos. Entre os exemplos, aparece a análise de traces de execução para identificar falhas e sugerir correções.

Como funciona e como começar

A instalação recomendada é a integração HA-MCP, que roda o servidor dentro do próprio Home Assistant. Segundo o projeto, ela funciona em todos os tipos de instalação (OS, Supervised, Container e Core), com os mesmos recursos. Exige Home Assistant 2026.8.0 ou mais recente e é instalada via HACS ou, a partir da versão 2026.11, pelo Marketplace.

Na configuração, o usuário informa um token de administrador e define como os clientes se conectam. O acesso remoto passa por um webhook do Home Assistant, via Nabu Casa ou proxy reverso, e o acesso local usa uma porta direta na rede. O site afirma que o servidor funciona com Claude Desktop, Claude.ai, ChatGPT, Cursor, Copilot e mais de 15 clientes de IA.

Quem usa Home Assistant OS ou Supervised pode instalar como app (add-on), sem gerenciar token. O README orienta usar apenas um método de instalação por vez.

Maturidade e atividade

O repositório foi criado em 14 de setembro de 2025, usa licença MIT e está em Python. Soma 452 forks, e o último commit é de 11 de novembro de 2026. O README já trata da versão 9.0.0, de 28 de outubro de 2026, e avisa que a versão 7.3.0 moveu a ferramenta ha_config_set_yaml para beta.

Cuidados ao adotar

O servidor age com conta de administrador. O README alerta que um token de longa duração na conta pessoal funciona de qualquer lugar se vazar, e que as alterações aparecem no nome do usuário. A alternativa indicada como mais segura é criar uma conta exclusiva para o HA-MCP, com login só local e permissão de administrador.

O acesso remoto e o acesso pela rede local começam desativados. As ferramentas de edição de arquivos e YAML são opcionais e vêm desligadas por padrão.

Pontos-chave

• Painel de administração na barra lateral do Home Assistant para gerenciar ferramentas, backups e temas
• Autenticação opcional por login do Home Assistant, em vez de URL secreta
• Está no catálogo padrão do HACS, sem precisar de repositório personalizado
• Servidor de demonstração local (stdio) disponível para macOS, Linux e Windows

Texto escrito por IA a partir das reportagens e páginas listadas abaixo e checado contra elas por uma segunda revisão automática. Atualizado em 11/11/2026 às 20:00 (Brasília).