Vue d'ensemble

ha-mcp (The Unofficial and Awesome Home Assistant MCP Server) est le serveur Model Context Protocol communautaire de référence qui transforme votre instance Home Assistant en un outil puissant pour les assistants IA. Il permet aux LLM comme Claude, Cursor, Gemini CLI et tout client compatible MCP d'interagir directement avec votre maison intelligente en utilisant le langage naturel.

Bien que Home Assistant inclue désormais une intégration officielle mcp_server, ha-mcp offre des capacités nettement plus riches (plus de 80 outils), un module complémentaire facile pour HA OS et un assistant de configuration dédié – ce qui en fait le choix privilégié pour la plupart des utilisateurs.

Fonctionnalités principales

Contrôle en langage naturel : Allumer/éteindre les lumières, réguler le climat, ouvrir les volets, lire des médias et exécuter n'importe quel service.
Requêtes d'état et d'entités en temps réel : Demander les valeurs des capteurs, l'état des appareils ou un résumé complet de la maison.
Gestion des automatisations : Créer, modifier, activer/désactiver, déclencher ou mettre en pause des automatisations de façon dynamique.
Capacités avancées : Édition YAML, gestion HACS, génération de tableaux de bord Lovelace, gestion des mises à jour, sauvegardes et plus de 80 outils spécialisés.
Prise en charge multi-clients : Fonctionne parfaitement avec Claude Desktop, Cursor, VS Code + Cline, Gemini CLI et plus encore.
Installation facile : Module complémentaire officiel pour HA OS, Docker ou options d'exécution rapide.
Sécurisé et fiable : Utilise des jetons d'accès de longue durée avec une authentification appropriée.

Cas d'utilisation

Maison intelligente mains-libres : "Éteins toutes les lumières en bas et verrouille la porte d'entrée."
Automatisations pilotées par IA : "Crée une automatisation qui allume la lumière du porche au coucher du soleil et me notifie."
Édition des tableaux de bord et configurations : Laissez Cursor ou Claude générer et déployer des tableaux de bord Lovelace ou des configurations YAML.
Surveillance et dépannage : "Quelle est la température actuelle dans la chambre et pourquoi le capteur de mouvement est-il hors ligne ?"
Flux de travail complexes : Combinez avec d'autres serveurs MCP pour des pipelines complets maison + développement orchestrés par l'IA.

Installation (Méthode la plus simple)

Module complémentaire Home Assistant OS

Ajoutez le dépôt https://github.com/homeassistant-ai/ha-mcp dans votre Boutique de modules complémentaires HA.
Installez et démarrez le module complémentaire Home Assistant MCP Server.
Générez un jeton d'accès de longue durée et configurez-le.
Utilisez l'assistant de configuration officiel : https://homeassistant-ai.github.io/ha-mcp/setup/

Options alternatives : Docker, uvx ou installation manuelle depuis le dépôt.

Compatibilité

Clients : Claude Desktop, Cursor, Gemini CLI, Codex, toute application conforme à MCP.
Home Assistant : Fonctionne avec les versions actuelles de HA (OS, Container, Core).
Licence : Open-source (consultez le dépôt pour les termes exacts).

Communauté et alternatives

Il s'agit de la version la plus activement maintenue et la plus riche en fonctionnalités (v7.1.0+ en mars 2026). D'autres forks communautaires existent, mais le ha-mcp de l'organisation homeassistant-ai est celui le plus recommandé sur les forums, YouTube et Reddit.

L'intégration officielle mcp_server de Home Assistant est également disponible pour des cas d'utilisation plus légers.

Commencez à contrôler votre maison intelligente avec l'IA dès aujourd'hui — ha-mcp le rend simple, puissant et amusant.

Serveur MCP pour Home Assistant