Nosotros y terceros seleccionados usamos cookies o tecnologías similares con fines técnicos y, con tu consentimiento, para analizar cómo se usa el sitio.

Puedes dar, negar o retirar libremente tu consentimiento en cualquier momento.

Home Assistant (ha-mcp)

Servidor MCP de homeassistant-ai

Controla y configura dispositivos, estados, automatizaciones, scripts y paneles de Home Assistant en lenguaje natural.

Se ejecuta en local (Se ejecuta en tu equipo: su página tiene el comando de instalación)Se ejecuta con uvxRequiere clave de API

Instalar Home Assistant (ha-mcp)

Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:

uvx ha-mcp@latest

Requiere uv (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.

  • HOMEASSISTANT_URL Your Home Assistant URL.
  • HOMEASSISTANT_TOKEN secreto Home Assistant long-lived access token.

Compartir este servidor

El enlace abre esta página, con el comando de instalación y los pasos de configuración.

mcp.tc/i/home-assistant

Descripción

Un servidor no oficial creado por la comunidad que conecta un asistente de IA con una instancia de Home Assistant. Te permite controlar dispositivos del hogar inteligente, consultar estados de entidades, llamar a servicios y gestionar automatizaciones, scripts y paneles en lenguaje natural.

Puede ejecutarse como componente personalizado de Home Assistant instalado mediante HACS, como app de Home Assistant (add-on), en Docker o de forma local con uvx ha-mcp@latest. El componente y la app sirven Streamable HTTP y no necesitan token de acceso. Las configuraciones con Docker y uvx necesitan HOMEASSISTANT_URL y un token de acceso de larga duración en HOMEASSISTANT_TOKEN. El transporte stdio está documentado como con problemas conocidos.

Qué puedes hacer

  • Controlar dispositivos del hogar inteligente y llamar a servicios de Home Assistant
  • Consultar estados de entidades
  • Gestionar automatizaciones y scripts
  • Configurar paneles
  • Ejecutar como componente personalizado de HACS, app, Docker o paquete uvx
  • Autenticación OIDC opcional para acceso remoto

Herramientas

Home Assistant (ha-mcp) solo muestra sus herramientas a clientes con clave, así que no podemos listarlas aquí.

Prompts de ejemplo

  • Apaga todas las luces del salón

  • ¿Cuál es la temperatura actual del dormitorio?

  • Crea una automatización que encienda la luz del porche al atardecer

  • Lista mis automatizaciones e indícame cuáles están desactivadas

Configuración

Todos los clientes inician Home Assistant (ha-mcp) en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.

Claude Code

  1. Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport stdio home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latest
  1. Inicia Claude Code y escribe /mcp. home-assistant debería aparecer como conectado.

Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.

Claude Desktop

  1. Abre Settings → Developer → Edit Config. Se abre claude_desktop_config.json. Añade:
claude_desktop_config.json
{
  "mcpServers": {
    "home-assistant": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
        "HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
      }
    }
  }
}
  1. Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.

Necesita uv (Python) en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.

Cursor

O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):

mcp.json
{
  "mcpServers": {
    "home-assistant": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
        "HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
      }
    }
  }
}

Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.

VS Code

Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:

.vscode/mcp.json
{
  "servers": {
    "home-assistant": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
        "HOMEASSISTANT_TOKEN": "${input:homeassistant-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "homeassistant-token",
      "description": "HOMEASSISTANT_TOKEN",
      "password": true
    }
  ]
}

Necesita uv (Python) en tu equipo.

Devin Desktop

  1. Añádelo a ~/.config/devin/mcp_config.json (macOS y Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "home-assistant": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
        "HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
      }
    }
  }
}
  1. Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.

Devin Desktop es el nuevo nombre de Windsurf.

Codex

codex mcp add home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latest

O edita directamente ~/.codex/config.toml:

config.toml
[mcp_servers.home-assistant]
command = "uvx"
args = ["ha-mcp@latest"]
env = { HOMEASSISTANT_URL = "<YOUR_HOMEASSISTANT_URL>", HOMEASSISTANT_TOKEN = "<YOUR_HOMEASSISTANT_TOKEN>" }

Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.

Gemini CLI

gemini mcp add -e "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" -e "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" home-assistant uvx ha-mcp@latest

Así lo añades al proyecto actual. Añade -s user para usarlo en todas partes.

Cualquier cliente

La mayoría de los clientes que inician servidores locales aceptan esta forma:

{
  "mcpServers": {
    "home-assistant": {
      "command": "uvx",
      "args": [
        "ha-mcp@latest"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
        "HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
      }
    }
  }
}

Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.

Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.

Insertar

Muestra Home Assistant (ha-mcp) en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones

La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.

Insignia para README

Vista previa de la insignia, claraVista previa de la insignia, oscura
Markdown
[![Home Assistant (ha-mcp) on mcp.tc](https://mcp.tc/i/home-assistant/badge.svg)](https://mcp.tc/i/home-assistant)
HTML
<a href="https://mcp.tc/i/home-assistant"><img src="https://mcp.tc/i/home-assistant/badge.svg" alt="Home Assistant (ha-mcp) on mcp.tc" height="20"></a>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML
<script src="https://mcp.tc/w/home-assistant.js" async></script>

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/home-assistant" title="Home Assistant (ha-mcp) on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

https://mcp.tc/i/home-assistant.json

Qué significa cada campo

Prompt para la IA

Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de Home Assistant (ha-mcp) a tu web.

Markdown
Añade a mi web la tarjeta de mcp.tc de Home Assistant (ha-mcp), un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.

Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:

```html
<script src="https://mcp.tc/w/home-assistant.js" async></script>
```

Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.

```html
<div data-mcptc="home-assistant"><a href="https://mcp.tc/i/home-assistant">Home Assistant (ha-mcp) on mcp.tc</a></div>
```

Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.

Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).

Para un README u otra documentación en Markdown, usa la insignia:

```markdown
[![Home Assistant (ha-mcp) on mcp.tc](https://mcp.tc/i/home-assistant/badge.svg)](https://mcp.tc/i/home-assistant)
```

Referencia: https://mcp.tc/es/embed

Historial de cambios

Este servidor se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: cada versión nueva aparece aquí, junto con las ediciones de su responsable.

Sigue Home Assistant (ha-mcp) y te enviaremos un correo cuando algo cambie.

  1. , Comprobación automática

    Nueva versión 9.2.0 (antes 9.1.2). Leída en PyPI.

  2. , Comprobación automática

    Nueva versión 9.1.2 (antes 9.1.1). Leída en PyPI.

  3. , Comprobación automática

    Nueva versión 9.1.1 (antes 9.1.0). Leída en PyPI.

  4. , Comprobación automática

    Nueva versión 9.1.0 (antes 9.0.0). Leída en PyPI.

  5. , Comprobación automática

    Nueva versión 9.0.0 (antes 8.7.0). Leída en PyPI.

  6. , Comprobación automática

    Nueva versión 8.7.0 (antes 8.6.0). Leída en PyPI.

  7. , Comprobación automática

    Inicio del seguimiento: versión 8.6.0.

Preguntas frecuentes

¿Puedo pegar mcp.tc/i/home-assistant en mi cliente MCP?

No. Home Assistant (ha-mcp) se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es uvx ha-mcp@latest.

¿Home Assistant (ha-mcp) necesita una clave de API?

Sí. Lee HOMEASSISTANT_URL y HOMEASSISTANT_TOKEN de su entorno, y HOMEASSISTANT_TOKEN es un secreto. Pon el valor en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.

¿Home Assistant (ha-mcp) es un servidor remoto o local?

Local. Tu cliente lo inicia como un proceso en tu equipo con uvx ha-mcp@latest, que necesita uv (Python).

¿Qué puede hacer Home Assistant (ha-mcp)?

Puedes controlar dispositivos del hogar inteligente y llamar a servicios de Home Assistant, consultar estados de entidades y gestionar automatizaciones y scripts.

¿Qué clientes pueden usarlo?

Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.

¿mcp.tc sigue los cambios de Home Assistant (ha-mcp)?

En parte. Se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: su pestaña Historial muestra cada versión nueva y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.

¿Quién escribió esta página?

El robot de mcp.tc leyó los metadatos públicos de Home Assistant (ha-mcp) (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.

mcp.tc no tiene relación con homeassistant-ai. Esta página se creó a partir de los metadatos públicos de Home Assistant (ha-mcp), comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.