Back to Home
kaichiachen icon

homeassistant-mcp-server

Verified Safe

by kaichiachen

Overview

Connects AI assistants to Home Assistant, enabling AI agents to control and query smart home entities and services.

Installation

Run Command
docker run -d --name homeassistant-mcp-server -p 8000:8000 -e HA_URL="http://your-home-assistant-ip:8123" -e HA_TOKEN="your-long-lived-access-token" ghcr.io/kaichiachen/homeassistant-mcp-server:latest

Environment Variables

  • HA_URL
  • HA_TOKEN

Security Notes

Secrets (HA_TOKEN, HA_URL) are configured via environment variables or Home Assistant add-on options, not hardcoded. The server's functionality relies on a Home Assistant long-lived access token, which grants broad control over the HA instance; its security is paramount. The server uses `json.loads` for parsing input parameters to service calls, which is generally safe for data but could be a vector for vulnerabilities if Home Assistant services themselves are susceptible to specially crafted JSON. Network access to the MCP server on port 8000 should be restricted to trusted clients. No `eval` or `exec` found. The code handles common HTTP errors robustly.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens2500
Stars0
Forks0
Last Update2026-01-17

Tags

Home AssistantMCP ServerAI IntegrationSmart HomeAdd-on