# Advanced Homeassistant Mcp > MCP server that gives AI assistants control over your Home Assistant. Including 50+ tools over 3 transports. Batteries included 🔋 - **Type:** MCP server - **Install:** `agentstack add mcp-jango-blockchained-advanced-homeassistant-mcp` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [jango-blockchained](https://agentstack.voostack.com/s/jango-blockchained) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [jango-blockchained](https://github.com/jango-blockchained) - **Source:** https://github.com/jango-blockchained/advanced-homeassistant-mcp - **Website:** https://jango-blockchained.github.io/advanced-homeassistant-mcp/ ## Install ```sh agentstack add mcp-jango-blockchained-advanced-homeassistant-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 🏠 Home Assistant MCP [](https://smithery.ai/server/@jango-blockchained/advanced-homeassistant-mcp) [](https://github.com/jango-blockchained/advanced-homeassistant-mcp/releases) [](https://www.npmjs.com/package/@jango-blockchained/homeassistant-mcp) [](https://github.com/jango-blockchained/advanced-homeassistant-mcp/pkgs/container/advanced-homeassistant-mcp) [](https://github.com/jango-blockchained/advanced-homeassistant-mcp/actions) [](https://bun.sh) [](https://nodejs.org) [](LICENSE) > **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](https://www.home-assistant.io/docs/authentication/#your-account-profile)). ### Claude Desktop Add to `claude_desktop_config.json`: ```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. ### Cursor / VS Code Cursor — add to .cursor/mcp.json ```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" } } } } ``` 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": { "HASS_HOST": "${env:HASS_HOST}", "HASS_TOKEN": "${env:HASS_TOKEN}" } } } } ``` ### Smithery (One-Click) Install directly from the [Smithery registry](https://smithery.ai/server/@jango-blockchained/advanced-homeassistant-mcp) — 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 | | **Fans** | list, get, speed, oscillation, direction, preset | | **Vacuums** | list, get, start/stop/dock, spot clean, fan speed | | **Alarm** | list, get, arm home/away/night, disarm | | **Switches** | list, get, turn on/off/toggle | | **Scenes** | list, activate named scene | | **Automations** | list, toggle, trigger, create/edit/delete | | **Notifications** | push alerts via HA channels | | **History** | query historical states | | **Add-ons** | install, configure, control | | **Packages** | HACS integrations and custom components | | **Maintenance** | orphaned devices, battery warnings, energy analysis | | **Smart Scenarios** | nobody-home mode, window/heat conflicts, energy waste | | **Lighting** | animations, scenarios, showcase, BPM/beat detection | | **Voice** | wake word detection, speech-to-text, voice commands | | **Dashboard** | query and manage Lovelace dashboards | | **Templates** | render Jinja2 templates via HA | | **To-Do Lists** | add, update, remove items | | **Traces** | automation/script execution traces | | **Search** | full-text entity search with filters | | **Entity State** | get current state of any entity | | **Error Log** | query HA error logs with filtering | Full docs: [Tools Reference](https://jango-blockchained.github.io/advanced-homeassistant-mcp/tools/ha-tools/) --- ## 🎙️ Speech Features (Voice Control) Transform your setup into a fully voice-controlled smart home assistant. The speech integration provides local, privacy-focused voice processing. - **Wake Word Detection**: Powered by `wyoming-openwakeword` (default: "Hey Jarvis"). - **Speech-to-Text**: Fast, local transcription using `faster-whisper`. - **Audio Integration**: Direct PulseAudio integration for seamless microphone access. To enable speech features, use the dedicated Docker Compose file: ```bash docker-compose -f docker-compose.speech.yml up -d ``` See the [Speech Features Guide](https://jango-blockchained.github.io/advanced-homeassistant-mcp/guides/speech-features/) for detailed configuration and setup instructions. --- ## 🧱 Architecture ``` ┌──────────────┐ ┌─────────────────────┐ ┌──────────────────┐ │ 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. - **STDIO** — for Claude Desktop, Cursor, VS Code (local editor integrations) - **HTTP+WS** — for remote AI hosts, with JWT auth, rate limiting, and WebSocket streaming - **HTTP (fastmcp)** — lightweight HTTP transport without bespoke middleware --- ## ⚙️ Configuration Minimal setup. Two variables are required: ```env HASS_HOST=http://homeassistant.local:8123 HASS_TOKEN=eyJ... # long-lived access token ``` Optional: ```env 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](https://jango-blockchained.github.io/advanced-homeassistant-mcp/configuration/environment/). --- ## 🛠️ Development ```bash 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 ``` Built with [Bun](https://bun.sh), TypeScript, and [fastmcp](https://github.com/punkpeye/fastmcp). Three entry points: - `dist/index.cjs` — HTTP+WS on a custom Express-based MCP server - `dist/stdio-server.mjs` — STDIO via fastmcp v3 - `dist/http-server.mjs` — HTTP via fastmcp v3 --- ## 📖 Docs Full documentation lives at **[jango-blockchained.github.io/advanced-homeassistant-mcp](https://jango-blockchained.github.io/advanced-homeassistant-mcp/)** — covers installation, configuration, all 50+ tools, deployment (HTTP, STDIO, Smithery), architecture deep-dives, and guides. --- ## 🤝 Contributing PRs welcome. Keep it simple — same code style, add tests, update docs if you touch public APIs. 1. Fork it 2. Branch it 3. Code it 4. Test it 5. PR it See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guidelines. --- ## 📄 License MIT — go build something cool. --- **Your smart home speaks MCP. Now your AI speaks it too.** 🏠⚡🤖🔋 > Batteries included. 🔋 ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [jango-blockchained](https://github.com/jango-blockchained) - **Source:** [jango-blockchained/advanced-homeassistant-mcp](https://github.com/jango-blockchained/advanced-homeassistant-mcp) - **License:** Apache-2.0 - **Homepage:** https://jango-blockchained.github.io/advanced-homeassistant-mcp/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-jango-blockchained-advanced-homeassistant-mcp - Seller: https://agentstack.voostack.com/s/jango-blockchained - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.