Blog / Article #175

Domotique et IA locale : quand Home Assistant rencontre ha-mcp, et que ça devient magique (ou presque)

L'autre jour, en bricolant mon Home Assistant, je me suis dit : « Et si ma maison était vraiment intelligente ? Pas juste des routines pré-écrites du genre 'si mouvement et nuit, allume la lumière', mais une IA capable de comprendre le contexte, mes habitudes, et d'agir en conséquence, sans envoyer toutes mes données chez Google ou Amazon. » La promesse de l'IA locale dans mon homelab, ça me titillait déjà pour d'autres projets, mais l'appliquer à la domotique, c'était le Graal. C'est là que j'ai découvert ha-mcp, et que ma quête de la domotique ultime a pris un tournant inattendu.

L'IA dans mon Homelab, pourquoi pas la domotique ?

On est d'accord, Home Assistant est déjà une bête de guerre. On peut tout faire ou presque. Mais quand il s'agit de passer du 'si ceci, alors cela' à une véritable 'compréhension' de l'environnement, on atteint vite les limites des automatisations classiques. J'avais envie de pouvoir dire : « Il fait frais, je rentre du travail, et j'ai l'habitude de lire à cette heure-ci... mets l'ambiance cocooning et lance ma playlist chill. » Sans avoir à créer 36 entités et 12 conditions dans mon YAML. Bref, je voulais un assistant qui pense, ou du moins qui simule la pensée.

L'idée d'utiliser un Grand Modèle de Langage (LLM) pour ça est venue naturellement. Mais hors de question de brancher mon Home Assistant directement sur ChatGPT ou Claude sans un intermédiaire qui respecte un minimum ma vie privée et me donne le contrôle. C'est là que ha-mcp, un projet de homeassistant-ai, entre en scène.

ha-mcp : Qu'est-ce que c'est et pourquoi c'est un game changer pour Home Assistant

ha-mcp, ou « Home Assistant MCP Server », est un serveur qui implémente le Model Context Protocol (MCP). En gros, c'est le traducteur universel entre votre assistant IA (qu'il soit local comme Ollama, ou même un service cloud si vous n'avez pas peur de l'exposer) et votre Home Assistant. Il expose une quantité astronomique d'outils (87 outils répartis en 6 catégories !) permettant à l'IA de contrôler vos appareils, interroger leurs états, gérer les automatisations, configurer des tableaux de bord et même faire des sauvegardes. Oui, tout ça, via le langage naturel.

Pour moi, c'est un game changer parce que :

• Contrôle total : L'IA peut faire bien plus que juste allumer une lumière. Elle peut interagir avec presque tous les aspects de Home Assistant.
• Flexibilité : Que vous utilisiez Ollama en local, ou que vous soyez un aventurier du cloud avec Claude ou ChatGPT, ha-mcp est compatible.
• Local-first : La possibilité de tout garder chez soi avec Ollama, c'est le top pour la confidentialité.

Pré-requis : Un Home Assistant fonctionnel et un LLM local (Ollama) prêt à l'emploi

Avant de plonger, assurez-vous d'avoir quelques bases :

• Home Assistant : Une instance fonctionnelle, idéalement à jour (version 2026.8.0 ou plus récente est recommandée pour l'intégration facile).
• Ollama : Un serveur Ollama en cours d'exécution sur votre réseau local, avec au moins un modèle téléchargé (par exemple, ollama pull mistral). Si vous ne l'avez pas encore, l'installation est un jeu d'enfant :

  curl -fsSL https://ollama.com/install.sh | sh

  puis pour télécharger un modèle :

  ollama pull mistral

  N'oubliez pas de rendre Ollama accessible sur votre réseau en définissant la variable d'environnement OLLAMA_HOST à 0.0.0.0:11434 si besoin.

Installation et configuration de ha-mcp : Guide pas à pas

La méthode la plus simple et recommandée est l'intégration Home Assistant. Assurez-vous d'être sur Home Assistant 2026.8.0 ou plus récent.

1. Ajouter l'intégration :

   Si vous êtes sur Home Assistant 2026.11 ou plus récent : Allez dans Settings → Marketplace, recherchez HA-MCP, puis cliquez sur Install.

   Si vous êtes sur Home Assistant 2026.8–2026.10 : Ouvrez HACS, recherchez HA-MCP, puis cliquez sur Download.

2. Redémarrer Home Assistant : Une fois l'intégration installée, redémarrez votre instance Home Assistant.
3. Créer un compte dédié : Pour des raisons de sécurité et de traçabilité, je vous conseille vivement de créer un compte administrateur dédié à ha-mcp dans Home Assistant. Alternativement, vous pouvez générer un jeton d'accès à long terme depuis votre profil. Traitez ce jeton comme un mot de passe !
4. Configurer l'intégration : Allez dans Settings → Devices & Services → Add Integration, recherchez HA-MCP et choisissez HA-MCP Server. Vous devrez fournir l'URL de votre Home Assistant et le jeton d'accès à long terme que vous avez créé.

Une fois l'intégration configurée, l'URL de connexion pour votre agent IA sera disponible dans l'écran de configuration de l'intégration (Settings → Devices & Services → “HA-MCP — Manage Home Assistant with AI” → HA-MCP Server → Configure). Il peut s'agir d'un webhook Home Assistant ou d'une adresse réseau locale.

Pour les plus avancés, une configuration via un fichier config.yaml est possible. Voici un exemple basique :

homeassistant:  url: "http://localhost:8123" # Ou l'adresse de votre HA  access_token: "votre_jeton_d_acces_a_long_terme_ici"  timeout: 30.0 # Délai d'attente des requêtes en secondes  verify_ssl: true # Vérifier les certificats SSL  cache_ttl: 300 # Mettre en cache les états des entités pendant 5 minutesmcp:  debug: false # Activer la journalisation de débogage  log_level: "INFO" # Niveau de journalisation (DEBUG, INFO, WARNING, ERROR)

C'est ce jeton et cette URL que vous utiliserez pour connecter votre agent IA (Ollama dans notre cas) à ha-mcp.

Premières automatisations intelligentes : Exemples concrets

Maintenant que ha-mcp est le pont, comment ça marche avec Ollama ? L'intégration Ollama native de Home Assistant (disponible depuis Home Assistant 2026.7) est votre meilleure amie ici.

1. Intégrer Ollama dans Home Assistant : Allez dans Settings → Devices & Services → Add Integration, recherchez