Home Assistant en Google Home gratis: configuración manual actualizada

Albert BarnosellEditor y responsable de Tecnoyfoto

Actualizado el 27 de agosto de 2026. Puedes conectar Home Assistant con Google Home sin pagar Home Assistant Cloud, pero el método manual exige acceso HTTPS desde Internet, un proyecto en Google Home Developer Console, vinculación OAuth y configuración en Home Assistant. La antigua consola Actions on Google ya no representa el flujo actual.

“Gratis” significa sin cuota de Home Assistant Cloud; no significa sencillo ni libre de mantenimiento. Tú eres responsable del dominio, HTTPS, exposición segura, credenciales de Google y futuras modificaciones de la plataforma.

Método manual o Home Assistant Cloud

Opción	Ventaja	Coste real
Home Assistant Cloud	Configuración rápida, sin abrir puertos ni administrar OAuth	Suscripción después de la prueba.
Configuración manual	Sin cuota de Nabu Casa y control del proyecto	Tiempo, dominio HTTPS, mantenimiento y mayor superficie de error.

Si prefieres simplicidad, consulta si Home Assistant Cloud vale la pena. El resto de esta guía describe el método manual oficial.

Requisitos antes de empezar

Home Assistant accesible externamente mediante un nombre de host y un certificado HTTPS válido.
No configures el certificado directamente en la integración HTTP si quieres utilizar Local Fulfillment; usa un proxy inverso correctamente configurado.
Una cuenta de Google y acceso a Google Home Developer Console y Google Cloud Console.
Copia reciente de Home Assistant y acceso al archivo configuration.yaml.
No publiques el archivo JSON de la cuenta de servicio ni lo subas a GitHub.

Crear la integración Cloud-to-Cloud en Google Home

En Google Home Developer Console crea un proyecto nuevo o selecciona uno dedicado a Home Assistant.
Añade una integración Cloud-to-Cloud y completa los tipos de dispositivo.
En Account Linking utiliza el flujo OAuth solicitado. El Client ID es https://oauth-redirect.googleusercontent.com/r/PROJECT_ID.
Configura la URL de autorización como https://TU_DOMINIO/auth/authorize, la URL de token como https://TU_DOMINIO/auth/token y el fulfillment como https://TU_DOMINIO/api/google_assistant.
Guarda el Project ID; se utilizará en Home Assistant.

Cuenta de servicio y HomeGraph API

En Google Cloud Console abre el mismo proyecto.
Habilita HomeGraph API.
Crea una cuenta de servicio y genera una clave JSON. Descárgala una sola vez y guárdala en la carpeta de configuración de Home Assistant con un nombre claro.
Restringe el acceso al archivo. No lo muestres en capturas y no lo guardes en un repositorio público.

Configurar Home Assistant

Añade una sección como esta y adapta el Project ID y la ruta del archivo. Utiliza expose_by_default: false para decidir expresamente qué entidades llegan a Google.

google_assistant:
  project_id: TU_PROJECT_ID
  service_account: !include SERVICE_ACCOUNT.json
  report_state: true
  expose_by_default: false
  entity_config:
    light.salon:
      expose: true
      room: Salón

Comprueba la configuración antes de reiniciar. Una entidad expuesta a Google sale de tu red local y sus estados pueden procesarse en la nube; publica solo lo necesario.

Vincular Home Assistant en Google Home

Reinicia Home Assistant y confirma que no hay errores en los registros.
Abre Google Home, pulsa Añadir → Funciona con Google Home y busca el nombre del proyecto marcado como prueba.
Inicia sesión en Home Assistant y autoriza la vinculación.
Asigna habitaciones y prueba una luz o interruptor no crítico.
Di “Hey Google, sincroniza mis dispositivos” cuando cambies entidades; también puedes usar HomeGraph Request Sync si lo has configurado.

Local Fulfillment: opcional

Local Fulfillment puede reducir latencia al enviar algunas órdenes directamente a Home Assistant dentro de la red. Sigue la documentación vigente de Google y Home Assistant, carga el JavaScript requerido y configura el descubrimiento mDNS. La nube sigue interviniendo en autenticación y como respaldo; no es una solución completamente desconectada.

Errores habituales

No aparece el proyecto: comprueba que la cuenta de Google sea la misma y que la integración esté preparada para pruebas.
Error de account linking: revisa dominio HTTPS, URLs exactas y Project ID.
404 en fulfillment: verifica /api/google_assistant, proxy y acceso externo.
Los dispositivos no aparecen: revisa expose_by_default, filtros y ejecuta la sincronización.
Credenciales caducan: revisa el estado de publicación/usuarios de prueba del proyecto y los avisos de Google Cloud.
Local Fulfillment falla: comprueba mDNS y que el certificado no esté configurado directamente en http:.

Seguridad y mantenimiento

Activa MFA para los administradores de Home Assistant.
No expongas el puerto 8123 sin una capa HTTPS correctamente mantenida.
Protege la cuenta de servicio, revisa accesos y elimina claves antiguas.
Después de una actualización importante, prueba vinculación, sincronización y una orden local.
Documenta el proyecto para poder recuperarlo sin guardar secretos en texto plano.

Conclusión

La integración manual continúa siendo viable y evita la cuota, pero Home Assistant Cloud es más apropiado para quien no quiera mantener OAuth, dominio y proxy. Si eliges el método gratuito, hazlo como un pequeño proyecto de infraestructura: seguro, documentado y probado.

Fuentes: Home Assistant Google Assistant y Google Home Cloud-to-Cloud.

Continúa leyendo