mcp-ha: un servidor MCP para Home Assistant, como add-on

Este add-on de Home Assistant expone un servidor MCP (Model Context Protocol). En la práctica: conectas Claude, Gemini o cualquier otro cliente MCP a tu instancia, y hablas con tu hogar.

"¿Qué luces quedaron encendidas?", "¿Por qué no se activó la automatización de la calefacción anoche?", "Grafica mi consumo de energía de la semana."

Documentación: devitek.github.io/mcp-ha (inglés y francés)

Qué cubre

16 herramientas en total, diseñadas para ahorrar la ventana de contexto del LLM: respuestas compactas, paginadas y limitadas, con notas que guían al asistente hacia consultas más precisas.

Related MCP server: hass-mcp

¿Por qué no la integración MCP oficial de HA?

Existe y funciona, pero pasa por la API de Assist: solo entidades expuestas a Assist, sin historial, sin registros, sin add-ons, sin configuraciones de automatización. Este add-on ofrece acceso directo y granular. Ambos pueden coexistir.

Instalación

Requisitos: Home Assistant OS o Supervised (el add-on necesita el Supervisor).

1. Añade este repositorio a los repositorios de add-ons:

   

   O manualmente: Configuración, Add-ons, Tienda de add-ons, menú de tres puntos, Repositorios, y pega https://github.com/Devitek/mcp-ha.

2. Instala "MCP Home Assistant" e inícialo.

3. Abre la pestaña de Configuración del add-on: se generó y guardó un token de API allí en el primer arranque (también se imprime en el registro del add-on).

Conectando un cliente

Claude Code:

claude mcp add --transport http home-assistant \
  http://HA_IP:9583/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop y Gemini CLI: consulta la guía de clientes en el sitio de documentación.

Seguridad, en resumen

• Solo lectura por defecto. La herramienta de llamada a servicios ni siquiera existe para el cliente a menos que habilites allow_write.

• Defensa en profundidad cuando la escritura está habilitada: lista de denegación de servicios peligrosos (apagado de HA, shell_command...), listas glob de permitir/denegar para entidades, modo dry_run, rastro de auditoría JSON de cada intento en el registro.

• Solo LAN. Sin TLS, sin OAuth: no expongas el puerto 9583 a internet.

El modelo de amenazas completo está en SECURITY.md.

Documentación

• Sitio de documentación: instalación, configuración, clientes, referencia de herramientas, arquitectura (inglés y francés)

• Documentación del add-on: la página que se muestra en la interfaz de HA

• Guía de contribución: configuración de desarrollo, convenciones, versiones

• Incidencias del repositorio: la base de conocimiento del proyecto, cada decisión de diseño y escollo se rastrea allí con las etiquetas décision y écueil (en francés)

Licencia

MIT