Home Assistant MCP Server

by vortitronio.github.Vortitron/home-assistant-mcpv0.10.0

Home Assistant and ESPHome for coding agents: states, services, automations, dashboards, flashing.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Home Assistant MCP server

claude mcp add home-assistant-vortitron -e HA_TOKEN='<ha-token>' -e VOMEHOME_TOKEN='<vomehome-token>' -- npx -y @vortitron/home-assistant-mcp

{
  "mcpServers": {
    "home-assistant-vortitron": {
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_TOKEN": "<ha-token>",
        "VOMEHOME_TOKEN": "<vomehome-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "home-assistant-vortitron": {
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_TOKEN": "<ha-token>",
        "VOMEHOME_TOKEN": "<vomehome-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "home-assistant-vortitron": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_TOKEN": "<ha-token>",
        "VOMEHOME_TOKEN": "<vomehome-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "home-assistant-vortitron": {
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_TOKEN": "<ha-token>",
        "VOMEHOME_TOKEN": "<vomehome-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
HA_URL	—	—	Your Home Assistant's address, e.g. http://homeassistant.local:8123 (or use VOMEHOME_TOKEN instead)
HA_TOKEN	—	yes	A Home Assistant long-lived access token
HA_ALLOW_WRITE	—	—	Set to true to allow service calls and edits; reads only without it
VOMEHOME_TOKEN	—	yes	A key from the Vome app's Agent tab, to reach the home through Vome instead of HA_URL and HA_TOKEN

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-10-03 · 7d ago · GitHub · v0.10.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-04 · 6d ago · official registry · v0.10.0

FAQ

›How do I install the Home Assistant MCP server in Claude Code?

Run: claude mcp add home-assistant-vortitron -e HA_TOKEN='<ha-token>' -e VOMEHOME_TOKEN='<vomehome-token>' -- npx -y @vortitron/home-assistant-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Home Assistant require an API key?

Yes. It expects HA_TOKEN, VOMEHOME_TOKEN, of which 2 are secrets.

›Can I use Home Assistant as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Home Assistant in the official MCP registry?

Yes, as io.github.Vortitron/home-assistant-mcp.