Home Assistant MCP : piloter votre maison connectée avec Claude et ChatGPT (guide 2026)

Par Amir N., éditeur de serveurmcp.com

Home Assistant intègre un serveur MCP officiel depuis sa version 2025.2. Votre assistant IA, comme Claude ou ChatGPT, peut alors contrôler votre maison connectée et répondre à vos questions sur vos appareils, avec les mêmes capacités que l’assistant vocal de Home Assistant.

Un projet communautaire, ha-mcp, va plus loin, avec des outils pour gérer aussi vos automatisations.

Le serveur MCP officiel en bref

• Intégration : Model Context Protocol Server, disponible depuis Home Assistant 2025.2.
• Adresse : /api/mcp sur votre instance, en Streamable HTTP.
• Ce que voit l’IA : l’API Assist, limitée aux entités exposées à l’assistant.
• Connexion : OAuth, ou jeton d’accès longue durée pour les clients qui ne gèrent pas OAuth.

Installation

1. Dans Home Assistant, ouvrez Paramètres, puis Appareils et services, et ajoutez l’intégration Model Context Protocol Server.
2. Choisissez les entités exposées à l’assistant : l’IA ne pourra contrôler qu’elles.
3. Connectez votre client à l’adresse /api/mcp de votre instance, comme ci-dessous.

Claude

Ajoutez un connecteur personnalisé avec l’adresse https://votre-url-externe/api/mcp, ou votre adresse Home Assistant Cloud, https://votre-id.ui.nabu.casa/api/mcp. Indiquez https://claude.ai comme identifiant client OAuth et laissez le secret vide, puis connectez-vous à Home Assistant pour autoriser l’accès.

La connexion passe par l’infrastructure cloud d’Anthropic : votre instance doit donc être accessible depuis Internet. Sinon, Claude Desktop peut passer par le pont local mcp-proxy, avec un jeton d’accès longue durée.

ChatGPT

La connexion est disponible pour les offres Plus, Pro, Business et Enterprise/Edu, uniquement à distance. Utilisez la même adresse, choisissez OAuth, indiquez https://chatgpt.com comme identifiant client, et saisissez n’importe quel texte comme secret : Home Assistant ne l’utilise pas.

Claude Code et Codex

Dans Claude Code, ajoutez le serveur distant :

claude mcp add --transport http homeassistant https://votre-instance/api/mcp

Codex se connecte aussi en OAuth, avec l’identifiant client http://127.0.0.1:12345, comme l’indique la documentation de Home Assistant.

Les pièges à éviter

• L’adresse utilisée par le client doit correspondre exactement à l’URL interne ou externe configurée dans Paramètres, Système, Réseau. Sinon, la connexion OAuth échoue.
• L’identifiant client est l’adresse de l’application d’IA, comme https://claude.ai, jamais celle de votre Home Assistant.
• Home Assistant n’accepte pas l’enregistrement dynamique des clients. Si votre client le tente, saisissez les paramètres OAuth à la main.

Sécurité

• N’exposez à l’assistant que les entités nécessaires.
• Une option permet de réserver l’accès à /api/mcp aux comptes administrateurs.
• Un accès distant expose votre instance sur Internet : passez par HTTPS, Home Assistant Cloud ou un tunnel sécurisé.
• Claude demande votre autorisation avant d’utiliser les outils de Home Assistant.

Notre checklist de sécurité MCP complète ces règles.

L’alternative communautaire : ha-mcp

Le serveur non officiel ha-mcp, près de 5 000 étoiles sur GitHub, permet de contrôler les appareils, de consulter leurs états, d’exécuter des services et de gérer vos automatisations.

• L’installation recommandée passe par son composant personnalisé, disponible dans HACS. Le serveur tourne alors dans Home Assistant, sur tous les types d’installation.
• Sur Home Assistant OS, il existe aussi sous forme d’app, sans jeton à gérer. Home Assistant 2026.2 a renommé les modules complémentaires en « apps ».
• Ses outils d’édition de fichiers et de YAML sont désactivés par défaut.

Questions fréquentes

Home Assistant a-t-il un serveur MCP officiel ?

Oui, l’intégration Model Context Protocol Server, disponible depuis la version 2025.2.

Quelle est l’adresse du serveur ?

/api/mcp sur votre instance Home Assistant.

Faut-il exposer Home Assistant sur Internet ?

Pour le connecteur de Claude et pour ChatGPT, oui. En local, Claude Desktop peut passer par mcp-proxy avec un jeton d’accès longue durée.

L’IA peut-elle tout contrôler ?

Non, seulement les entités que vous exposez à l’assistant.

Quelle différence avec ha-mcp ?

ha-mcp est un projet communautaire qui propose davantage d’outils, notamment pour gérer les automatisations.

Sources

• Documentation officielle de l’intégration Model Context Protocol Server, consultée le 8 octobre 2026
• Dépôt de ha-mcp et son README