# 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. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2570/hass-mcp

## Description

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.

## Health score

69/100 (Good), based on 4 of 5 factors.
- Maintained: 84 (last commit 19 days ago)
- Popular: 51 (353 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/voska/hass-mcp
- GitHub: https://github.com/voska/hass-mcp
- Unraid: https://ca.unraid.net/apps/hass-mcp-10029yx0whh4yd?q=hass-mcp

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2570/hass-mcp), the self-hosted and open-source app directory.
