Back to Home
homeassistant-ai icon

ha-mcp

Verified Safe

by homeassistant-ai

Overview

Provides AI agents with complete control over Home Assistant via REST and WebSocket APIs, offering a comprehensive suite of tools for smart home management, automation, and debugging.

Installation

Run Command
python -m ha_mcp web

Environment Variables

  • HOMEASSISTANT_URL
  • HOMEASSISTANT_TOKEN
  • MCP_PORT
  • MCP_HOST
  • LOG_LEVEL
  • FUZZY_THRESHOLD
  • HAMCP_ENABLE_FILESYSTEM_TOOLS
  • HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION

Security Notes

The server securely handles Home Assistant API tokens via environment variables and uses encryption for OAuth credentials. Filesystem access tools are explicitly feature-flagged and operate within a well-defined sandbox, blocking path traversal. Jinja2 template evaluation is delegated to Home Assistant's core, offloading potential security risks. The primary 'risk' is the extensive control granted to AI agents over a smart home environment, which is the intended functionality.

Similar Servers

Stats

Interest Score95
Security Score8
Cost ClassHigh
Avg Tokens350
Stars255
Forks11
Last Update2026-01-19

Tags

Home AssistantSmart HomeAI IntegrationMCPAutomationDevice ControlAPI