MCP setup (Cursor / VS Code / Claude)

1. Mint a token at https://vome.io/account/api-tokens (GitHub sign-in).
2. Add to ~/.cursor/mcp.json (one entry per HA instance):

Hosted (recommended — no install, no Node required):

{
  "mcpServers": {
    "vome": {
      "type": "http",
      "url": "https://vome.io/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  }
}

One entry reaches every instance the token is scoped to.

Local alternative (runs the server on your machine):

{
  "mcpServers": {
    "ha-home": {
      "command": "npx",
      "args": ["-y", "@vortitron/home-assistant-mcp"],
      "env": {
        "VOMEHOME_TOKEN": "<your token>",
        "VOMEHOME_INSTANCE_ID": "<instance id from the tokens page>"
      }
    }
  }
}

Needs Node 18+ with npx on PATH. A "Connection closed" error almost
always means the agent could not find npx: check "which npx", and if
that works, set command to that absolute path (editors spawn MCP
servers with a minimal environment). On Windows use WSL.

Permissions live on the token (server-side): read-only by default;
per-instance ha:write / ha:config and account-wide instances:write
are granted per token on the tokens page and revocable any time.

Direct mode (no Vome account): set HA_URL + HA_TOKEN instead — see
https://github.com/Vortitron/home-assistant-mcp#readme