jango-blockchained/advanced-homeassistant-mcp

> Talk to your house. Your AI assistant (Claude, GPT, Cursor, Copilot) — connected to Home Assistant through the Model Context Protocol. 50+ tools, three transports, one bunx command.
bash
# ⚡ Fastest way to try it
bunx github:jango-blockchained/advanced-homeassistant-mcp
## 🚀 Quick Start
You need a Home Assistant instance and a long-lived access token (create one here).
### Claude Desktop
Add to claudedesktopconfig.json:
json
"mcpServers": {
"homeassistant-mcp": {
"command": "bunx",
"args": ["github:jango-blockchained/advanced-homeassistant-mcp"],
"env": {
"HASSHOST": "http://your-ha-instance:8123",
"HASSTOKEN": "yourlonglivedaccesstoken"
Restart Claude. You're done. Ask it to turn on the lights.
### Cursor / VS Code
Cursor — add to .cursor/mcp.json
json
"mcpServers": {
"homeassistant-mcp": {
"command": "bunx",
"args": ["github:jango-blockchained/advanced-homeassistant-mcp"],
"env": {
"HASSHOST": "http://your-ha-instance:8123",
"HASSTOKEN": "yourlonglivedaccesstoken"
VS Code + MCP Extension
Set your env vars in a .env file and use the pre-configured .vscode/mcp.json:
json
"mcp.servers": {
"homeassistant-mcp": {
"type": "stdio",
"command": "bun",
"args": ["run", "dist/stdio-server.mjs"],
"env": {
"HASSHOST": "${env:HASSHOST}",
"HASSTOKEN": "${env:HASSTOKEN}"
### Smithery (One-Click)
Install directly from the Smithery registry — no config files needed:
bash
npx @smithery/cli install @jango-blockchained/advanced-homeassistant-mcp --client claude
## 📦 All Install Options
| Method | Command |
| Smithery (easiest) | npx @smithery/cli install @jango-blockchained/advanced-homeassistant-mcp --client claude |
| bunx (no install) | bunx github:jango-blockchained/advanced-homeassistant-mcp |
| npx | npx @jango-blockchained/homeassistant-mcp@latest |
| Docker | docker run -d -p 7123:7123 --env-file .env ghcr.io/jango-blockchained/advanced-homeassistant-mcp:1.7.0 |
| From source | git clone ... && bun install && bun run build:all && bun run start:stdio |
| npm global | npm add -g @jango-blockchained/homeassistant-mcp && homeassistant-mcp |
Available Docker tags:
latest - Latest stable release
1.7.3, 1.7, 1 - Tagged versions
dev - Latest development build from main branch
## 🎯 What You Can Do
Once connected, you talk to your house like you talk to a human:
"Turn off all lights in the bedroom"
"Set the thermostat to 72°F"
"Lock all doors and start the vacuum"
"Show me energy consumption this week"
"What's the temperature in the living room?"
"Activate the movie scene"
"Notify everyone that dinner is ready"
"Check my Home Assistant health"
"Find orphaned devices with low battery"
"Analyze my light usage patterns"
Every command maps to one of 50+ tools — lights, climate, media, locks, covers, fans, vacuums, alarms, scenes, automations, notifications, history, energy monitoring, maintenance, and more.
Full tool reference (all 50+ tools)
| Category | Tools |
| Lights | list, get, turn on/off, brightness, color temp, RGB, effects |
| Climate | list, get, HVAC modes, target temp, fan mode, humidify |
| Media | list, get, play/pause, volume, source, sound mode, shuffle |
| Covers | list, get, open/close, position, tilt, garage door |
| Locks | list, get, lock/unlock with code support |