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.

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