Skip to content
MCP server

HomeAssistant Light MCP

Control Home Assistant lights and scenes. Lights only by design for safety.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.6.1
Listing updated
4 days ago

About HomeAssistant Light MCP

HomeAssistant Light MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add homeassistant-light-mcp --env HA_URL='<HA_URL>' --env HA_TOKEN='<HA_TOKEN>' -- npx -y ha-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "homeassistant-light-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "homeassistant-light-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "homeassistant-light-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "homeassistant-light-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "homeassistant-light-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ha-mcp-server"
      ],
      "env": {
        "HA_URL": "<HA_URL>",
        "HA_TOKEN": "<HA_TOKEN>"
      }
    }
  }
}

Configuration

  • HA_URLHome Assistant URL (e.g., http://192.168.1.100:8123)Required
  • HA_TOKENHome Assistant long-lived access tokenRequired

Pricing

Open source

HomeAssistant Light MCP FAQ

Is HomeAssistant Light MCP free?

Yes. HomeAssistant Light MCP is open source, so you can use and self-host it for free.

How do I add HomeAssistant Light MCP to Claude Code?

Run this command in your terminal: claude mcp add homeassistant-light-mcp --env HA_URL='<HA_URL>' --env HA_TOKEN='<HA_TOKEN>' -- npx -y ha-mcp-server