clr-homeassistant-mcp

Home Assistant smart home control

Install

pip install clr-homeassistant-mcp
# or
uvx clr-homeassistant-mcp

Configuration

Preferred: Configuration file at ~/.config/homeassistant/credentials.json (chmod 600):

Single instance:

{
  "url": "https://homeassistant.local:8123",
  "token": "your-long-lived-access-token"
}

Multi-instance:

{
  "instances": {
    "home": {
      "url": "https://home.example.com",
      "token": "home-token-here"
    },
    "office": {
      "url": "https://office.example.com",
      "token": "office-token-here"
    }
  },
  "default": "home"
}

Alternative: Environment variables are also supported (single instance only):

Variable	Description	Example
HA_URL	Home Assistant URL	https://homeassistant.local:8123
HA_TOKEN	Long-lived access token	your-token

Optional:

Variable	Description	Default
HA_READ_ONLY	Run in read-only mode	false
HA_TRANSPORT	Transport protocol (stdio or http)	stdio
HA_LOG_LEVEL	Log level	INFO

Get token: Settings → Long-Lived Access Tokens in Home Assistant UI

See --help for additional options:

clr-homeassistant-mcp --help

Development

git clone https://github.com/clearminds/clr-homeassistant-mcp.git
cd clr-homeassistant-mcp
uv sync
uv run clr-homeassistant-mcp

License

MIT