About
MCP server for Home Assistant smart home control
README
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
Install Clr Homeassistant in Claude Desktop, Claude Code & Cursor
unyly install clr-homeassistantInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add clr-homeassistant -- uvx clr-homeassistant-mcpStep-by-step: how to install Clr Homeassistant
FAQ
Is Clr Homeassistant MCP free?
Yes, Clr Homeassistant MCP is free — one-click install via Unyly at no cost.
Does Clr Homeassistant need an API key?
No, Clr Homeassistant runs without API keys or environment variables.
Is Clr Homeassistant hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Clr Homeassistant in Claude Desktop, Claude Code or Cursor?
Open Clr Homeassistant on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiSupabase
Database, auth and storage
by SupabaseEverything
Reference / test server with prompts, resources, and tools.
Git
Tools to read, search, and manipulate Git repositories.
Sequential Thinking
Dynamic and reflective problem-solving through thought sequences.
Time
Time and timezone conversion capabilities.
Compare Clr Homeassistant with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs