Hass-MCP

Hass-MCP is a Model Context Protocol (MCP) server that connects Home Assistant to AI assistants such as Claude and other large language model (LLM) clients.

  • AI
  • Home Automation
  • Tools & Utilities
Hass-MCP is a Model Context Protocol (MCP) server that connects Home Assistant to AI assistants such as Claude and other large language model (LLM) clients. It exposes Home Assistant over HTTP/SSE through a built-in supergateway bridge, letting any MCP client query device and sensor states, control lights and switches, search entities, and troubleshoot automations.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
84last commit 19 days ago
Popular
51353 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 24 days ago

GitHub stars
353
Open issues
8
Last commit
2026-11-02
Latest release
v0.6.1
License
MIT
Activity
rising

Checked 8 days ago - source: GitHub (voska/hass-mcp)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set MQTT broker address, port, and login Before starting, put your Home Assistant MQTT broker address, port, username, password, and TLS setting in the app’s service settings. MQTT is the message system Home Assistant uses to discover and control devices, so if these are wrong, HASS.Agent cannot publish its controls or receive commands. source
  • Check HASS.Agent answers on port 5580 Confirm the machine running HASS.Agent is reachable at http://your-device:5580/ and responds with HASS.Agent Active, since 5580 is the default web port. Without that response, Home Assistant’s integration setup can fail and the device may stay unavailable. source
  • Use logs to fix MQTT connection timeouts If the log says MQTT failed to connect to homeassistant.local:1883, check the broker address, port 1883, login details, and any firewall blocking the connection. This timeout means the app cannot talk to Home Assistant, so its switches and buttons will not work. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Will hass-mcp reach Home Assistant if both run in Docker on the same machine?

If Home Assistant is also Dockerized on the same host, the hass-mcp container may need --network host in its Docker args. Alternatively, point it at the machine's IP address instead of localhost.

Why does the full tool catalog disappear after renaming the MCP client entry?

Renaming the client key from Home Assistant (ha-mcp) to a value like HASS ha-mcp, while keeping the same URL and other settings, can make the full tool catalog reappear after a restart.

How do I manage tools, feature flags, and backups in hass-mcp?

ha-mcp ships a web settings page for enabling, disabling, and pinning tools, toggling feature flags and beta settings, managing automatic backups, and reviewing tool-approval requests. How you reach the page depends on how ha-mcp is running.

What should I check when hass-mcp has connection problems?

Check the logs and use Debug Mode when investigating connection issues. The troubleshooting page also points to community resources and issue reporting.

Answers sourced from github.com, github.com, homeassistant-ai.github.io, mmornati.github.io

Community

Collected 47 days ago - public community threads