hass-mcp

hass-mcp

Docker app from louij2's Repository

Overview

Home Assistant MCP server, bridged over HTTP with supergateway (baked into the image, on a current Node.js so supergateway's MCP SDK actually works) so any MCP client that speaks HTTP/SSE can use it.

Readme

View on GitHub

hass-mcp

Home Assistant MCP server — layers a current Node.js (20+) onto voska/hass-mcp so supergateway can bridge it over HTTP. The upstream image ships Debian's Node 18, which doesn't have globalThis.crypto that supergateway's MCP SDK needs — this just replaces the Node binary and stdlib with the node:20-slim build.

Build

docker build -t hass-mcp:latest .

Run

Needs a Home Assistant long-lived access token passed at container-start time via a bind-mounted secret file, never baked into the image. Point it at your Home Assistant instance's URL.

Install hass-mcp on Unraid in a few clicks.

Find hass-mcp in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for hass-mcp Review the template variables and paths Click Install
Explore Unraid OS

Requirements

A Home Assistant long-lived access token (Profile -> Security -> Long-lived access tokens).

Categories

Tools > UtilitiesUtilities

Download Statistics

36
Total Downloads

Related apps

Explore more like this

Explore all
Utilities appsUtilities

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
louij2/hass-mcp:latest
Registry
https://hub.docker.com/r/voska/hass-mcp
Last Updated2026-09-16
First Seen2026-09-18

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--memory=512m --cpus=0.5

Template configuration

Host Port 8094Porttcp

HTTP port supergateway serves the bridged MCP endpoint on.

Target
8094
Default
8094
Value
8094
hass-tokenPathro

Read-only bind mount to a file containing your Home Assistant long-lived access token (never put the token directly in a Variable).

Target
/run/secrets/tok
Value
/mnt/user/appdata/hass-mcp/hass-token
HA_URLVariable

e.g. http://10.0.0.24:8123