SMART HOME / HM-SH-009
HM-SH-009 · datasheet

hass-mcp

Control and query Home Assistant from Claude and other LLMs

01 · What it does

  • Entity Management: Get states, control devices, and search for entities
  • Domain Summaries: Get high-level information about entity types
  • Automation Support: List and control automations
  • Guided Conversations: Use prompts for common tasks like creating automations
  • Smart Search: Find entities by name, type, or state

02 · Install

$ docker run -i --rm -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN voska/hass-mcp
$ claude mcp add hass-mcp -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN -- docker run -i --rm -e HA_URL -e HA_TOKEN voska/hass-mcp
$ uvx hass-mcp --http --port 8000
$ docker run --rm -p 8000:8000 \

03 · Client config (Claude Desktop / Cursor, from README)

{
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "HA_URL",
           "-e",
           "HA_TOKEN",
           "voska/hass-mcp"
         ],
         "env": {
           "HA_URL": "http://homeassistant.local:8123",
           "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
         }
       }
     }
   }

Commands copied from the project README. Placeholders are the maintainer's. Not bench-tested by HardwareMCP yet.

Weekly bulletin

New hardware MCP servers and setups that actually worked on a bench. One email, Fridays.