hass-mcp

Un servidor MCP de código abierto para controlar y consultar Home Assistant.

• Transporte: stdio

• Autenticación: Token de larga duración de Home Assistant

• API: API REST de Home Assistant

Características

Herramientas expuestas:

• ha_get_state — obtener el estado de una entidad

• ha_list_states — listar todos los estados (puede ser grande)

• ha_call_service — llamar a cualquier servicio

Instalación

pnpm install
pnpm build

Ejecución

export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"

pnpm start

Configuración en un cliente MCP

Ejemplo (conceptual):

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "hass-mcp"],
      "env": {
        "HASS_URL": "http://homeassistant.local:8123",
        "HASS_TOKEN": "..."
      }
    }
  }
}

Seguridad

• Trate los tokens como secretos.

• Prefiera ejecutar este servidor en la misma red local (LAN) que Home Assistant.

• Si su HA está detrás de Cloudflare Access, ejecute este servidor MCP en el lado de la LAN.

Licencia

MIT