McpMux
Back to Registry

Home Assistant (Docker) MCP Server

Community

Contributed by voska

Control and query your Home Assistant smart home from AI assistants via Docker. Get device and sensor states, control entities, summarize your home, search entities, and troubleshoot automations.

About the Home Assistant (Docker) MCP Server

The Home Assistant (Docker) MCP server is a local (stdio) Model Context Protocol server available in the McpMux registry. Control and query your Home Assistant smart home from AI assistants via Docker. Get device and sensor states, control entities, summarize your home, search entities, and troubleshoot automations. This is a community-contributed MCP server by voska.

Install the Home Assistant (Docker) MCP server with one click using McpMux. It works with Cursor, Claude Desktop, Claude Code, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible AI client. This server requires an API key — McpMux securely stores your credentials with AES-256-GCM encryption.

Transport Configuration

Transport Configuration
{
  "type": "stdio",
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HA_URL",
    "-e",
    "HA_TOKEN",
    "voska/hass-mcp"
  ],
  "env": {
    "HA_URL": "${input:HA_URL}",
    "HA_TOKEN": "${input:HA_TOKEN}"
  },
  "metadata": {
    "inputs": [
      {
        "id": "HA_URL",
        "label": "Home Assistant URL",
        "description": "Base URL of your Home Assistant instance. The container reaches it over the network, so use a routable hostname or IP (e.g. http://homeassistant.local:8123), not localhost.",
        "type": "url",
        "required": true,
        "placeholder": "http://homeassistant.local:8123"
      },
      {
        "id": "HA_TOKEN",
        "label": "Long-Lived Access Token",
        "description": "A Home Assistant Long-Lived Access Token used to authenticate API requests.",
        "type": "text",
        "required": true,
        "secret": true,
        "placeholder": "********************",
        "obtain": {
          "url": "https://www.home-assistant.io/docs/authentication/#your-account-profile",
          "instructions": "1. Open Home Assistant in your browser\n2. Click your user profile (bottom-left)\n3. Go to the Security tab and scroll to Long-Lived Access Tokens\n4. Click Create Token, name it, and copy the value (shown only once)",
          "button_label": "Open Profile"
        }
      }
    ]
  }
}
Details
TransportLocal (stdio)
Hostinglocal
AuthAPI Key
Capabilities
ToolsResourcesPrompts

Categories

Tags

home-assistantsmart-homehome-automationiotdocker

Supported AI Clients

The Home Assistant (Docker) MCP server works with all MCP-compatible AI clients through McpMux:

CursorClaude DesktopClaude CodeVS CodeChatGPTWindsurfJetBrainsZedClineGemini CLIAmazon Q

Related MCP Servers

Install Home Assistant (Docker) with McpMux

One-click install from the McpMux desktop app. Auto-configures for Cursor, Claude, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible client.