Descripción general
HA-MCP es un servidor MCP (Model Context Protocol) que se ejecuta dentro de Home Assistant y permite a un asistente de IA (Claude, ChatGPT u otro cliente compatible) consultar, controlar y configurar tu casa: crear automatizaciones, scripts, paneles y ayudantes, revisar trazas e historial y hacer copias de seguridad.
Esquema: NODARA.
Requisitos
- Un cliente compatible con MCP.
- HACS → ⋮ → Repositorios personalizados, añade
https://github.com/homeassistant-ai/ha-mcp-integrationcon tipo Integración, descárgalo y reinicia. - Ajustes → Dispositivos y servicios → Añadir integración → HA-MCP Custom Component → HA-MCP Server, y copia la URL de conexión en Configurar.
- Repositorio: homeassistant-ai/ha-mcp-integration.
Ideas de uso
- Crear automatizaciones hablando: «enciende el porche al atardecer». Es el ejemplo de abajo.
- Depurar: «la luz del pasillo no se enciende con movimiento, revísalo», y que lea las trazas.
- Diseñar paneles: «añade una gráfica de temperatura por habitación».
- Auditoría: «¿qué automatizaciones usan entidades que ya no existen?».
- Limpieza: «lista las entidades no disponibles desde hace más de una semana».
- Conexión de solo lectura (
/readonly) para un asistente que solo consulte.
Ejemplo de uso
No hay YAML que escribir: se usa conversando. Por ejemplo:
Acción
«Crea una automatización que encienda
la luz del porche al atardecer»Resultado
Automatización creada y activa
con disparador sun.sunsetSeguridad:
- La URL de conexión es la credencial: trátala como una contraseña.
- Si solo lo usas en casa, desactiva Acceso remoto por webhook.
- Añadiendo
/readonlyal final de la URL, esa conexión solo puede leer. Hay también un modo solo lectura general y aprobación por herramienta. - Haz copias de seguridad antes de pedir cambios grandes.
Diferencia con el servidor MCP oficial: el oficial solo controla las entidades expuestas a Assist. HA-MCP también crea y edita configuración.