LibreAI / Agents IA / ha-mcp
// agents · homeassistant-ai/ha-mcp

ha-mcp

ha-mcp est un projet de agents IA open source, créé par homeassistant-ai (homeassistant-ai/ha-mcp sur GitHub). Il compte 4 977 étoiles sur GitHub et 231 forks, il est publié sous la licence MIT et a été mis à jour pour la dernière fois sur GitHub le 8 octobre 2026.

The unofficial Home Assistant MCP server — control and automate your smart home from any AI assistant.

★ 5,0 k étoiles⑂ 231 forksMITmis à jour oct. 2026
▦ visuel — le README de ce projet ne contient aucune capture intégrable,
voici donc un emplacement réservé. Le guide ci-dessous est complet malgré tout.
// détails du projet

Détails du projet

Étoiles GitHub
4 977
Forks
231
Licence
MIT
Dernière mise à jour sur GitHub
8 octobre 2026
Catégorie
Agents IA
Type de fiche
Guide d'installation complet
Site officiel
Official site
// fonctionnement

Comment ça marche

  1. Clarify what your assistant should do

    Decide which parts of your home the assistant may see and control, and which client (Claude or another MCP client) you will use.

  2. Choose an install method

    Pick one: the in-process HACS integration, the Docker HTTP server, or the uvx/PyPI server — running more than one is not supported.

  3. Connect to Home Assistant

    Point the server at your Home Assistant URL with a long-lived access token (an administrator's is recommended), or finish the in-app setup.

  4. Ask your first command

    Ask your assistant about your home — list lights, check a sensor, run a script — through the MCP tools.

// fonctionnalités

Pourquoi on l'adore

Full MCP access to Home Assistant

Exposes your Home Assistant entities and services as MCP tools so assistants can read state and take action.

In-process integration option

Can run inside Home Assistant itself via HACS, replacing the other install methods, with an admin-only HA-MCP settings panel in the sidebar.

Remote access via webhook

A Nabu Casa remote webhook URL lets cloud MCP clients reach your home securely; local-only mode disables the webhook entirely.

Flexible authentication

Options include the secret URL as credential, Home Assistant account sign-in (ha_auth), or OIDC via an external identity provider such as Authentik, Keycloak or Auth0.

Tool search for small contexts

An optional ENABLE_TOOL_SEARCH mode defers the large tool catalog behind a search interface so models with small context windows (or capped clients) can still work.

Docker and PyPI servers

Run ghcr.io/homeassistant-ai/ha-mcp as an HTTP server, or the published ha-mcp package with uvx, pointed at your Home Assistant.

Advertisement
// lancez-le

Lancez-le vous-même

  1. Clone the repository

    Clone ha-mcp if you want the source or the manual integration files.

    git clone https://github.com/homeassistant-ai/ha-mcp.git
    cd ha-mcp
  2. Install with the one-command installer

    Run the installer for your OS and MCP client — this example wires up Claude Code on Linux.

    curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-linux.sh | sh
    # For Claude Code: curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install.sh | sh -s -- --claude-code
  3. Or run the server package

    Alternatively, serve ha-mcp over HTTP with uvx against your Home Assistant instance.

    uvx ha-mcp@latest # see README for the exact command
// cas d'usage

Ce que vous pouvez créer

Advertisement
// faq

Questions fréquentes

Who maintains ha-mcp?

ha-mcp is a community project from homeassistant-ai; it is unofficial and not affiliated with the Home Assistant project itself.

Is ha-mcp free?

Yes — it is open source under the MIT license. You need your own Home Assistant instance (also free and open source).

Does it need a paid API key?

No API key is required; the server authenticates to your Home Assistant with a long-lived access token you create. Remote access can use your Nabu Casa account if you have one.

How does it compare to Home Assistant's built-in Assist or LLM integrations?

Those live inside Home Assistant's own conversation features; ha-mcp exposes your home to external MCP clients and agents (Claude and others) with fine-grained install and auth options.

How do I get started?

Pick one install method — HACS integration is the most integrated — run the installer or add the integration, and connect your MCP client.

// continuez l'exploration

Outils similaires

Agents IA

google_workspace_mcp

Control Gmail, Calendar, Docs, Sheets, Drive and more from AI — a full Google Workspace MCP server.

★ 3,3 k étoilesMIT
Voir le guide →
Agents IA

deep-research

Deep Research with any LLM: in-depth reports in minutes, with an SSE API and MCP server built in

★ 4,7 k étoilesMIT
Voir le guide →
Agents IA

lamda

FIRERPA / LAMDA — full-stack Android device control: remote desktop, automation, MITM, Frida and MCP.

★ 8,6 k étoilesMIT
Voir le guide →
Agents IA

mcp

An MCP server that puts Hyperbrowser's browsers behind the protocol.

★ 789 étoilesMIT
Voir le guide →
Agents IA

github-mcp-server

GitHub's official MCP server — let AI tools work with repos, issues and pull requests

★ 33,4 k étoilesMIT
Voir le guide →
Agents IA

ouroboros

An Agent OS with interview-gated, budgeted evolution — one MCP server across 14 agent runtimes.

★ 6,2 k étoilesMIT
Voir le guide →
// alternatives

Alternatives en Agents IA

Les autres projets de la catégorie Agents IA avec le plus d'étoiles du catalogue LibreAI — la sélection réaliste d'alternatives si ha-mcp ne vous convient pas.

// plus en agents

Plus en Agents IA

Projets de la catégorie Agents IA proches dans le catalogue, les plus proches en étoiles de ha-mcp — continuez à explorer de part et d'autre.

Obtenir ha-mcp

Gratuit et ouvert : récupérez le code source, mettez une étoile au dépôt et commencez à créer.