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)
Dominio | Herramientas |
Entidades, áreas, dispositivos | búsqueda difusa, listas paginadas, detalles completos |
Servicios | catálogo por dominio, búsqueda, llamada protegida (opt-in) |
Automatizaciones | listado, estado, último disparo, configuración completa |
Scripts | listado, estado de ejecución |
Historial | cambios de estado, estadísticas a largo plazo, libro de registro |
Add-ons | listado y detalles (lectura) |
Sistema | renderizado de plantillas Jinja, configuración de HA, registro de errores |
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
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.
Requisitos: Home Assistant OS o Supervised (el add-on necesita el Supervisor).
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.
Instala "MCP Home Assistant" e inícialo.
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).
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.
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.
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)
This server cannot be deployed
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud