Resumen

ha-mcp (El Servidor MCP no Oficial e Increíble para Home Assistant) es el principal servidor del Protocolo de Contexto del Modelo (MCP) creado por la comunidad que convierte tu instancia de Home Assistant en una herramienta poderosa para asistentes de IA. Permite que LLMs como Claude, Cursor, Gemini CLI, y cualquier cliente compatible con MCP interactúen directamente con tu hogar inteligente usando lenguaje natural.

Aunque Home Assistant ahora incluye una integración oficial mcp_server, ha-mcp proporciona capacidades significativamente más ricas (más de 80 herramientas), un complemento fácil para HA OS y un asistente de configuración dedicado, lo que lo convierte en la elección preferida para la mayoría de usuarios.

Características Principales

Control por Lenguaje Natural: Encender/apagar luces, ajustar climatización, abrir persianas, reproducir medios y ejecutar cualquier servicio.
Consultas de Estado y Entidades en Tiempo Real: Preguntar por valores de sensores, estado de dispositivos o resúmenes completos del hogar.
Gestión de Automatizaciones: Crear, editar, activar/desactivar, disparar o pausar automatizaciones dinámicamente.
Capacidades Avanzadas: Edición de YAML, gestión de HACS, generación de paneles de control Lovelace, manejo de actualizaciones, copias de seguridad y más de 80 herramientas especializadas.
Soporte Multicliente: Funciona perfectamente con Claude Desktop, Cursor, VS Code + Cline, Gemini CLI y más.
Instalación Sencilla: Complemento oficial para HA OS, Docker u opciones de ejecución rápida (quick-run).
Seguro y Confiable: Utiliza tokens de acceso de larga duración con autenticación adecuada.

Casos de Uso

Hogar Inteligente sin Manos: "Apaga todas las luces de abajo y bloquea la puerta principal."
Automatizaciones Dirigidas por IA: "Crea una automatización que encienda la luz del porche al atardecer y me notifique."
Edición de Paneles y Configuración: Permite que Cursor o Claude generen e implementen paneles de control Lovelace o configuraciones YAML.
Monitoreo y Resolución de Problemas: "¿Cuál es la temperatura actual en el dormitorio y por qué el sensor de movimiento está fuera de línea?"
Flujos de Trabajo Complejos: Combínalo con otros servidores MCP para lograr flujos de trabajo completos orquestados por IA para el hogar y desarrollo.

Instalación (Método Más Fácil)

Complemento para Home Assistant OS

Añade el repositorio https://github.com/homeassistant-ai/ha-mcp en tu Tienda de Complementos de HA.
Instala e inicia el complemento Home Assistant MCP Server.
Genera un token de acceso de larga duración y configúralo.
Usa el asistente de configuración oficial: https://homeassistant-ai.github.io/ha-mcp/setup/

Opciones alternativas: Docker, uvx o instalación manual desde el repositorio.

Compatibilidad

Clientes: Claude Desktop, Cursor, Gemini CLI, Codex, cualquier aplicación compatible con MCP.
Home Assistant: Funciona con las versiones actuales de HA (OS, Contenedor, Core).
Licencia: Código abierto (consulta el repositorio para los términos exactos).

Comunidad y Alternativas

Esta es la versión con mayor mantenimiento activo y más funcionalidades (v7.1.0+ a partir de marzo de 2026). Existen otras versiones derivadas de la comunidad, pero ha-mcp de la organización homeassistant-ai es la más recomendada en foros, YouTube y Reddit.

La integración oficial mcp_server de Home Assistant también está disponible para casos de uso más sencillos.

Comienza a controlar tu hogar inteligente con IA hoy mismo: ha-mcp lo hace sencillo, potente y divertido.

Servidor MCP para Home Assistant