ha-mcp logo

ha-mcp

homeassistant-ai/ha-mcp

Unofficial Home Assistant MCP Server for AI model integration

GraphCanon updated Sep 20, 2026 · GitHub synced Sep 20, 2026

50views this month

4.8k stars217 forksLast push Sep 19, 2026 Python MIT

Decision brief

ha-mcp provides unofficial support for integrating AI models, specifically those from frameworks like Claude, into Home Assistant via the Model Context Protocol (MCP).

Good fit when

  • When you need to integrate Claude AI models as an MCP component in your Home Assistant setup.
  • For users who wish to experiment with new and unofficial MCP-supported models not officially supported by Home Assistant.

Avoid when

  • If official support for AI model integration is required, since ha-mcp lacks this endorsement.
  • Not suitable if you prioritize stability over experimenting with cutting-edge functionalities.

Observed Jul 16, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Very active (0d since push)
As of Sep 20, 2026
Provenance
Not a fork · Organization account
As of Sep 20, 2026
Security (OSV)
No MCP manifest
As of Jul 11, 2026

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install ha-mcp
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

The repository provides unofficial support for integrating AI models into Home Assistant through the Model Context Protocol (MCP). It supports frameworks like Claude.

Capability facts

Deploy
Self-host

Source: dockerfile:Dockerfile · Sep 20, 2026

Docker
Dockerfile present

Source: dockerfile:Dockerfile · Sep 20, 2026

CLI
CLI entrypoint

Source: pyproject.toml:[project.scripts] · Sep 20, 2026

MCP server
No MCP server detected

Source: repo_scan · Sep 20, 2026

Languages
python

Source: github.language+pyproject.toml · Sep 20, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

stdio transportstdio

Source: README excerpt (regex_v1, Sep 20, 2026)

- **Local stdio (not recommended):** runs ha-mcp on your own machine over stdio. The one-comman
Source link
Works with ChatGPTChatGPT

Source: README excerpt (regex_v1, Sep 20, 2026)

**ChatGPT / Codex behind a firewall (OpenAI Tunnel).** ChatGPT connectors normally requir
Source link

Tags

README

Other install methods These run the server outside Home Assistant — useful for Container / Core installs (which can't run apps) or a separate host. The Setup Wizard generates the exact client specific config for each. Docker (HTTP server): run in HTTP mode, pointed at your Home A...

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.