Conectar Home Assistant MCP con ChatGPT

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Home Assistant, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Home Assistant + ChatGPT

Deja que tu IA lea tu Home Assistant: el estado actual de cada sensor, luz, puerta y termostato, el historial registrado, el registro de lo que ocurrió y cuándo, y tus calendarios. Solo lectura: nunca controla dispositivos. Funciona con Home Assistant autoalojado.

Requisitos previos

Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Paso 1 — Obtén las credenciales

La configuración lleva unos 3 minutos. Necesitas una instancia de Home Assistant a la que AnythingMCP pueda acceder y un token de acceso de larga duración, idealmente de un usuario dedicado sin permisos de administrador.

1. Asigna a HOME_ASSISTANT_URL la dirección con la que abres Home Assistant, sin barra final y sin /api, por ejemplo https://home.example.com o http://192.168.1.10:8123 (el puerto por defecto es 8123).
2. Recomendado: crea un usuario de Home Assistant dedicado para AnythingMCP en Settings → People → Users → Add user, con Administrator desactivado. Ninguno de los endpoints que usa el conector necesita permisos de administrador.
3. Inicia sesión con ese usuario y haz clic en tu nombre, abajo a la izquierda, para abrir tu perfil. Abre la pestaña Security y, en Long-lived access tokens, haz clic en Create token. Copia el token (se muestra una sola vez y es válido durante 10 años) y pégalo en HOME_ASSISTANT_TOKEN, sin la palabra Bearer.
4. Instala el conector y ejecuta home_assistant_get_config: devuelve la versión, el nombre de la ubicación y la zona horaria, y confirma que la dirección y el token funcionan.

Qué lee: el estado actual de cada entidad (sensores, luces, climatización, puertas, presencia) con sus atributos, el historial registrado de valores durante un periodo, el registro de lo que ocurrió y cuándo (por ejemplo, cuándo se abrió por última vez la puerta del garaje), tus calendarios y sus eventos, y la configuración de la instancia. Los ids de entidad tienen un aspecto como sensor.living_room_temperature o binary_sensor.garage_door.

Solo lectura: todas las herramientas son peticiones GET. El conector no puede llamar a acciones (servicios), encender o apagar nada, abrir cerraduras, ejecutar scripts ni cambiar estados. El endpoint de acciones de Home Assistant no es exclusivo de administradores, así que esta garantía proviene de que el conector solo expone lecturas, no del token.

Dónde se ejecuta Home Assistant: en un AnythingMCP autoalojado, una instancia en una red privada (http://192.168.x.x:8123, homeassistant.local) requiere que un administrador permita el host en SSRF_ALLOWED_HOSTS o en la lista de permitidos de los ajustes de administración. AnythingMCP Cloud solo puede acceder a una instancia expuesta a internet por HTTPS, por ejemplo detrás de un proxy inverso o mediante el acceso remoto de Home Assistant Cloud.

Privacidad: los datos del hogar revelan quién está en casa y las rutinas diarias de sus habitantes. Asigna el conector únicamente a servidores MCP cuyos usuarios puedan ver estos datos.

Fechas y horas: las marcas de tiempo se envían en formato ISO 8601 en UTC con el sufijo Z, por ejemplo 2026-10-01T00:00:00Z. home_assistant_get_config devuelve la zona horaria del hogar para presentar los resultados.

Errores frecuentes: 401 significa que el token es incorrecto o fue eliminado. 404 en una entidad o en los eventos de su calendario significa que ninguna entidad tiene ese id; 404 en todas las llamadas significa que HOME_ASSISTANT_URL es incorrecta o ya termina en /api. 400 en los eventos de calendario significa que falta start o end, o que no es una marca de tiempo válida. Una conexión rechazada o bloqueada significa que el host no está permitido en la lista de permitidos de SSRF (autoalojado) o que no es público por HTTPS (Cloud).

El conector no llama a acciones ni servicios, no escribe ni elimina estados, no lanza eventos, no renderiza plantillas, no muestra imágenes de cámaras ni lee el flujo de eventos, el registro de errores o la API WebSocket (áreas, dispositivos, registro de entidades).

Paso 2 — Instala el adaptador

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añade el conector en ChatGPT

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestre YOUR_SERVER_ID.

ChatGPT añade los servidores MCP como plugins en su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio de trabajo Business solo pueden añadir uno los administradores y propietarios; en Enterprise y Edu, un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, haz clic en Add y después en Add custom MCP server.
2. Introduce un nombre, p. ej. Name: Home Assistant.
3. En Connection, introduce la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y mantén Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT te lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales, luego escribe @ en un chat y elígelo.

Herramientas disponibles

Preguntas frecuentes

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para planes de pago; el plan Free no figura en su lista.

Próximos pasos

• Página del conector
• Conectar con Claude