Clr Homeassistant

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):

Optional:

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