MCP Home Assistant

Français

English

Français

English

Apparence

MCP Home Assistant ​

Un add-on Home Assistant qui expose un serveur MCP (Model Context Protocol), pour qu'un assistant IA comme Claude ou Gemini puisse interroger et, si vous l'autorisez, piloter votre instance.

« Quelles lumières sont restées allumées ? », « Pourquoi l'automation du chauffage ne s'est pas déclenchée cette nuit ? », « Résume la consommation électrique de la semaine. »

Ce que ça fait ​

  • Entités, pièces, appareils : recherche floue, listes paginées, détail complet.
  • Services : parcours du catalogue et, quand l'écriture est activée, appel de services avec garde-fous.
  • Automations et scripts : état, dernier déclenchement, configuration complète des automations.
  • Historique : changements d'état, statistiques long terme, logbook.
  • Add-ons et système : add-ons installés, config HA, journal d'erreurs, rendu de templates Jinja.

19 outils au total (15 en lecture, 4 en écriture encadrée), pensés pour préserver la fenêtre de contexte du LLM : réponses compactes, paginées, plafonnées.

L'add-on est en lecture seule par défaut. Les outils d'écriture (ha_call_service, ha_run_script, ha_trigger_automation, ha_set_automation) n'existent qu'une fois allow_write activé, passent tous par le même chemin gardé (listes de services et d'entités, dry run, journal d'audit JSON), et les domaines sensibles comme serrures et alarmes exigent une confirmation en deux temps. Voir Sécurité.

Démarrage rapide ​

  1. Installez l'add-on depuis ce dépôt.

  2. Démarrez-le, puis ouvrez l'onglet Configuration de l'add-on : un jeton API y a été généré et enregistré.

  3. Connectez votre client, par exemple Claude Code :

    bash
    claude mcp add --transport http home-assistant \
  http://IP_DE_HA:9583/mcp \
  --header "Authorization: Bearer VOTRE_JETON"

  4. Demandez à votre assistant : « quelles lumières sont allumées en ce moment ? »

Prérequis ​

  • Home Assistant OS ou Supervised (l'add-on a besoin du Supervisor).
  • Un client MCP sur votre réseau local : Claude Code, Claude Desktop, Gemini CLI, ou tout client MCP en Streamable HTTP.

Documentation pour les LLMs ​

Cette documentation suit la convention llms.txt, pour être consommée directement par les assistants IA et les agents :

  • /llms.txt : un index compact avec résumé et liens décrits, idéal pour un agent qui choisit quoi lire.
  • /llms-full.txt : toute la documentation en un seul fichier markdown, idéal à coller dans une conversation ou à ingérer d'un bloc.
  • Chaque page anglaise existe aussi en markdown brut : ajoutez .md à son URL (ex. /reference/tools.md). Le miroir français n'a pas de jumeaux .md.

Ces fichiers sont régénérés à chaque build du site, en anglais uniquement. La documentation est aussi indexée sur Context7, pour les agents qui résolvent les docs via le serveur MCP Context7.

Pour aller plus loin ​