ha-mcp : piloter Home Assistant avec Claude ou ChatGPT

Home Assistant, c'est la plateforme libre qui pilote lumières, thermostats, capteurs et automatisations d'un bâtiment. Puissante, mais longue à configurer : chaque règle passe par des menus, du YAML ou des modèles à écrire à la main. ha-mcp change la donne : tu demandes à Claude ou à ChatGPT, en français ou en anglais, et l'assistant crée la règle, corrige le tableau de bord ou cherche pourquoi une automatisation ne se déclenche pas. Le dépôt compte 6783 stars sur GitHub et une licence MIT.

Concrètement, ha-mcp est un « serveur MCP ». MCP est un standard qui permet à un assistant IA d'utiliser des outils extérieurs, un peu comme une prise universelle. Ici, l'outil, c'est ton installation Home Assistant. Le README annonce 87 outils : chercher un appareil, lire un historique, créer un script, modifier un tableau de bord, lancer une sauvegarde.

Pourquoi c'est utile

• Tu décris le résultat voulu en une phrase, l'assistant écrit la configuration à ta place.
• Le diagnostic devient une conversation : l'assistant lit les traces d'exécution d'une automatisation et te dit où ça casse.
• Une modification existante se complète sans tout réécrire : le README cite l'exemple d'une routine du matin à laquelle on ajoute la cafetière.
• Les sauvegardes automatiques avant édition limitent le risque de casser ce qui marche.
• Un mode lecture seule permet de laisser l'IA observer sans rien changer.

Ce que l'outil sait faire

Le README range les capacités en six familles : recherche (retrouver un appareil parmi des centaines), contrôle (allumer, éteindre, agir sur plusieurs appareils d'un coup), gestion (automatisations, scripts, scènes, zones, calendriers, tableaux de bord), suivi (historique, statistiques, traces, images de caméra), système (sauvegarde, restauration, mises à jour) et sécurité.

Les exemples fournis parlent d'eux-mêmes : « crée une automatisation qui allume la lumière du porche au coucher du soleil », « ajoute une carte météo à mon tableau de bord », « l'automatisation du capteur de mouvement ne marche pas, trouve pourquoi ». Dans le dernier cas, l'assistant analyse les traces et propose une correction.

Pour une équipe, l'intérêt est surtout le gain de temps sur la partie ingrate de la domotique : la configuration et la maintenance. Celui qui administre l'installation n'a plus besoin de maîtriser chaque syntaxe pour obtenir un résultat propre. Le README ne donne en revanche aucun cas d'entreprise chiffré : ce qui suit sur les usages professionnels est notre lecture, pas une promesse du projet.

Comment l'installer

Le chemin recommandé est une intégration Home Assistant, installée depuis HACS ou, à partir de la version 2026.11, depuis le Marketplace intégré. Elle exige Home Assistant 2026.8.0 ou plus récent et fonctionne sur tous les types d'installation. Le principe tient en quelques gestes : installer, redémarrer, choisir quel compte administrateur le serveur utilise, puis copier l'adresse de connexion dans ton assistant IA.

Le README recommande de créer un compte dédié à ha-mcp plutôt que de réutiliser ton compte personnel. Bonne pratique : les modifications faites par l'IA sont alors identifiables à part.

D'autres modes existent : application Home Assistant (add-on), Docker, ou paquet Python. Un assistant de configuration en ligne génère la configuration pour plus de quinze clients, dont Claude Code, Gemini CLI, ChatGPT, Cursor et VSCode. Pour essayer sans toucher à ta vraie installation, le dépôt propose aussi un serveur de démonstration hébergé, avec des scripts pour macOS, Linux et Windows. Tu poses la question « Can you see my Home Assistant ? » et tu vois si la connexion marche.

Et le serveur intégré de Home Assistant ?

Home Assistant a déjà son propre serveur MCP. Il repose sur Assist, son système de commande vocale : il sait contrôler les appareils que tu as exposés à Assist, rien de plus. ha-mcp vise un autre usage, construire et entretenir la configuration.

La règle du README est simple : le serveur intégré pour piloter à la voix des appareils déjà exposés, ha-mcp quand tu veux qu'un assistant puisse aussi créer des automatisations, éditer des tableaux de bord, lire les journaux et gérer sauvegardes et registres.

À savoir avant de te lancer

Un outil qui peut modifier une installation demande de la prudence. Voici ce que le dépôt dit lui-même, et ce qu'il faut en retenir.

• Droits larges. Le serveur agit avec un compte administrateur. Un assistant mal guidé peut donc modifier ou supprimer des éléments. Garde le mode lecture seule pour les premiers essais et vérifie que les sauvegardes sont bien actives.
• Pas de plan de secours infaillible. Les sauvegardes avant édition sont un garde-fou, pas une assurance. Garde aussi tes sauvegardes habituelles de Home Assistant.
• Un seul mode d'installation à la fois. Le README prévient que deux entrées pour le même serveur dans un même client provoquent des blocages de connexion.
• Fonctions bêta. L'édition de fichiers et de YAML est désactivée par défaut et classée bêta. La documentation signale d'ailleurs un changement notable dans la version 7.3.0 pour l'une de ces fonctions.
• Petits modèles. Avec un modèle léger ou local, la liste de 87 outils peut le submerger. Le projet propose un mode de recherche d'outils pour ce cas.
• Mode « stdio » déconseillé. La connexion locale directe a des problèmes connus : à réserver aux essais.
• Un projet qui bouge vite. Le dépôt est actif, avec des versions fréquentes : relis la documentation avant chaque mise à jour.

Côté données, le README indique que le serveur tourne en local et que tes données restent sur ton réseau. Il n'y a pas de télémétrie aujourd'hui, et les rapports de bogue ne partent qu'avec ton accord explicite. Les échanges avec l'assistant IA que tu choisis restent soumis aux règles de son éditeur : vérifie-les si tes installations touchent à des informations sensibles.

Pour qui c'est

• Le responsable technique d'une PME qui gère des locaux équipés (éclairage, chauffage, accès) avec Home Assistant : il configure et dépanne plus vite, sans devenir spécialiste de chaque syntaxe.
• L'intégrateur ou le prestataire interne qui entretient plusieurs installations : la maintenance par la conversation et la lecture des traces réduisent le temps de diagnostic.
• L'équipe qui teste l'IA sur un cas concret : le serveur de démonstration permet d'essayer sans risque avant de brancher une vraie installation.
• Le passionné de domotique qui bloque sur le YAML : le plus à l'aise avec l'outil, puisque le projet est d'abord pensé pour lui.

À l'inverse, si tu n'utilises pas Home Assistant, l'outil ne sert à rien. Et si personne chez toi ne sait relire une automatisation, garde l'IA en lecture seule : une règle qu'on ne comprend pas reste un risque.

Bottom line

ha-mcp transforme Home Assistant, réputé pour sa courbe d'apprentissage, en un outil qu'on pilote par la conversation. Les gains sont réels sur la configuration et le dépannage, à condition d'encadrer les droits donnés à l'assistant et de garder des sauvegardes. Le code est ouvert, sous licence MIT, et la documentation d'installation est complète. Le dépôt est ici : github.com/homeassistant-ai/ha-mcp, avec l'assistant de configuration pour ton client IA.