hass-mcp

hass-mcp

Docker app from louij2's Repository

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…

Requirements

A Home Assistant long-lived access token (Profile -> Security -> Long-lived access tokens).
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.

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.

Categories

Download Statistics

740
Total Downloads

Related apps

Explore more like this

Explore all

Links

Details

Repository
louij2/hass-mcp:latest
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