Home Assistant MCP Server

Install in Claude Code

claude mcp add hass -e HA_URL='<ha-url>' -e HA_TOKEN='<ha-token>' -e HA_SSH_PASSWORD='<ha-ssh-password>' -- npx -y @jarahkon/hass-mcp-server

Install in Cursor

{
  "mcpServers": {
    "hass": {
      "command": "npx",
      "args": [
        "-y",
        "@jarahkon/hass-mcp-server"
      ],
      "env": {
        "HA_URL": "<ha-url>",
        "HA_TOKEN": "<ha-token>",
        "HA_SSH_PASSWORD": "<ha-ssh-password>"
      }
    }
  }
}

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

Install in Claude Desktop

{
  "mcpServers": {
    "hass": {
      "command": "npx",
      "args": [
        "-y",
        "@jarahkon/hass-mcp-server"
      ],
      "env": {
        "HA_URL": "<ha-url>",
        "HA_TOKEN": "<ha-token>",
        "HA_SSH_PASSWORD": "<ha-ssh-password>"
      }
    }
  }
}

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

Install in VS Code

{
  "servers": {
    "hass": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jarahkon/hass-mcp-server"
      ],
      "env": {
        "HA_URL": "<ha-url>",
        "HA_TOKEN": "<ha-token>",
        "HA_SSH_PASSWORD": "<ha-ssh-password>"
      }
    }
  }
}

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

Install in Windsurf

{
  "mcpServers": {
    "hass": {
      "command": "npx",
      "args": [
        "-y",
        "@jarahkon/hass-mcp-server"
      ],
      "env": {
        "HA_URL": "<ha-url>",
        "HA_TOKEN": "<ha-token>",
        "HA_SSH_PASSWORD": "<ha-ssh-password>"
      }
    }
  }
}

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