Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirTalk to your house. Your AI assistant (Claude, GPT, Cursor, Copilot) — connected to Home Assistant through the Model Context Protocol. 50+ tools, three transports, one
bunxcommand.
# ⚡ Fastest way to try it
bunx github:jango-blockchained/advanced-homeassistant-mcp
You need a Home Assistant instance and a long-lived access token (create one here).
Add to claude_desktop_config.json:
{
"mcpServers": {
"homeassistant-mcp": {
"command": "bunx",
"args": ["github:jango-blockchained/advanced-homeassistant-mcp"],
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
}
}
}
}
Restart Claude. You're done. Ask it to turn on the lights.
{
"mcpServers": {
"homeassistant-mcp": {
"command": "bunx",
"args": ["github:jango-blockchained/advanced-homeassistant-mcp"],
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
}
}
}
}
Set your env vars in a .env file and use the pre-configured .vscode/mcp.json:
{
"mcp.servers": {
"homeassistant-mcp": {
"type": "stdio",
"command": "bun",
"args": ["run", "dist/stdio-server.mjs"],
"env": {
"HASS_HOST": "${env:HASS_HOST}",
"HASS_TOKEN": "${env:HASS_TOKEN}"
}
}
}
}
Install directly from the Smithery registry — no config files needed:
npx @smithery/cli install @jango-blockchained/advanced-homeassistant-mcp --client claude
Available Docker tags:
latest - Latest stable release1.7.3, 1.7, 1 - Tagged versionsdev - Latest development build from main branchOnce 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 docs: Tools Reference
Transform your setup into a fully voice-controlled smart home assistant. The speech integration provides local, privacy-focused voice processing.
wyoming-openwakeword (default: "Hey Jarvis").faster-whisper.To enable speech features, use the dedicated Docker Compose file:
docker-compose -f docker-compose.speech.yml up -d
See the Speech Features Guide for detailed configuration and setup instructions.
┌──────────────┐ ┌─────────────────────┐ ┌──────────────────┐
│ AI Assistant │◄───►│ Home Assistant │◄───►│ Your Smart Home │
│ (Claude/GPT) │ │ MCP Server │ │ (Home Assistant)│
└──────────────┘ └─────────────────────┘ └──────────────────┘
│ │
┌────┘ └────┐
▼ ▼
┌────────────┐ ┌──────────────┐
│ HTTP/WS │ │ STDIO │
│ (Express) │ │ (fastmcp v3) │
└────────────┘ └──────────────┘
Three transports, one codebase. Pick the one that fits your setup — all expose the same 50+ tools.
Minimal setup. Two variables are required:
HASS_HOST=http://homeassistant.local:8123
HASS_TOKEN=eyJ... # long-lived access token
Optional:
PORT=7123 # HTTP server port (default: 4000)
LOG_LEVEL=info # debug | info | warn | error
JWT_SECRET=... # for HTTP/WS auth (min 32 chars)
For the full list of 20+ environment variables, see the Configuration docs.
bun install # install dependencies
bun run build:all # build all three entry points
bun test # run test suite (80% coverage threshold)
bun run lint # ESLint + Prettier
bun run typecheck # TypeScript type checking
dist/index.cjs — HTTP+WS on a custom Express-based MCP serverdist/stdio-server.mjs — STDIO via fastmcp v3dist/http-server.mjs — HTTP via fastmcp v3Full documentation lives at jango-blockchained.github.io/advanced-homeassistant-mcp — covers installation, configuration, all 50+ tools, deployment (HTTP, STDIO, Smithery), architecture deep-dives, and guides.
PRs welcome. Keep it simple — same code style, add tests, update docs if you touch public APIs.
See CONTRIBUTING.md for the full guidelines.
MIT — go build something cool.
Your smart home speaks MCP. Now your AI speaks it too. 🏠⚡🤖🔋
Batteries included. 🔋
MCP server that gives AI assistants control over your Home Assistant. Including 50+ tools over 3 transports. Batteries included 🔋
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Advanced Homeassistant roda localmente via stdio.
Última verificação: 2026-11-16. MCP server that gives AI assistants control over your Home Assistant. Including 50+ tools over 3 transports. Batteries included 🔋