Skip to main content
Glama
HomeMCP Gateway

HomeMCP Gateway

by manojmallick

HomeMCP Gateway

HomeMCP Gateway is a prototype policy layer for Home Assistant tools. It applies per-entity allow/deny rules, defaults to dry-run, and records decisions in an audit log. It runs with a stub Home Assistant client by default and can use the separately maintained hass-ts SDK for live connections.

Run locally

Requirements: Node.js and pnpm.

pnpm install
pnpm dev

Open http://localhost:3000/demo for the interactive demo. pnpm demo runs the command-line walkthrough. Stub mode requires no credentials.

Related MCP server: MCP Gatekeeper

Live Home Assistant

Set HASS_URL and HASS_TOKEN in the environment to connect to an instance. The token is a Home Assistant long-lived access token; keep it private and do not commit it. Live mode can control devices when dry-run is disabled. Review the policy and every requested operation before enabling side effects.

API

Method

Path

Purpose

GET

/v1/tools

List available MCP tools

POST

/v1/tools/call

Request a tool call subject to policy

GET / PUT

/v1/policies

Read or update entity permissions

GET

/v1/audit

View recent decisions

GET

/health

Check service mode and status

The default policy allows selected light/switch operations, permits sensor reads, and denies locks and alarms. Dry-run is enabled by default.

Build and checks

pnpm typecheck
pnpm test
pnpm build

Security limitations

This is a prototype, not a security-certified gateway. Do not expose it directly to the public internet: the API has no built-in user authentication. Put it behind a trusted network boundary and authenticated proxy. The audit/policy store is local JSON and is not designed for concurrent multi-instance deployments. Review policies carefully; live calls can operate real devices.

Docker deployment is available through a manually triggered workflow after provider settings are configured.

License

Licensed under the PolyForm Noncommercial License 1.0.0. This source-available license restricts commercial use; it is not an OSI-approved open-source license. See the license for terms and exceptions. Third-party dependencies retain their own licenses.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Local zero-trust permission gateway for AI agents. Enforces policy-based tool authorization, human approvals, scoped permissions, and cryptographically verifiable audit logs.
      4
      128 PyPI
      5
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables controlled AI-agent access to enterprise-shaped tools with a deny-by-default gated write path, human approval, dry-run execution, and append-only audit logging.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides permission gates and tamper-evident audit logging for AI agent tool executions, with declarative policies, consent ladders, and hash-chained verification.
      MIT