ha-addons
by mtebusi
Overview
Enables Claude Desktop to interact with Home Assistant instances using the Model Context Protocol (MCP) for smart home control and automation.
Installation
python rootfs/app/server.py --host 0.0.0.0 --port 8089 --ssl false --ha-url http://homeassistant.local:8123 --ha-token YOUR_HA_TOKENEnvironment Variables
- SUPERVISOR_TOKEN
- MCP_HOST
- MCP_PORT
- MCP_SSL
- MCP_CERTFILE
- MCP_KEYFILE
- HA_URL
- HA_TOKEN
- LOG_LEVEL
Security Notes
The server's OAuth2 authentication handler (`auth.py`) uses a hardcoded JWT secret ('secret') for signing and validating tokens. The code explicitly notes this is for 'development' and that 'in production, this would be the actual access token from HA', but its presence as-is makes the server critically vulnerable to token forgery by anyone aware of the hardcoded secret. This is a severe security flaw for any deployment where authentication is required. While other aspects like `yaml.safe_load`, structured logging, and network handling appear reasonable, the hardcoded secret fundamentally compromises the security of the authentication mechanism.
Similar Servers
ha-mcp
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.
openhab-mcp
This project provides an MCP (Model Context Protocol) server to enable AI assistants like Claude and Cline to interact with and manage a real openHAB smart home system via its REST API.
meraki-magic-mcp
Provides a comprehensive interface to manage Cisco Meraki network devices and configurations by exposing all Meraki SDK methods as tools, optimized for use with Claude Desktop.
Workshop-MCP-Server-Directions-Lab
This server integrates with Microsoft Dynamics 365 Business Central to expose its data and functionality as MCP tools for Claude Desktop, enabling AI-powered interactions with ERP data.