Home Assistant
About
Integrates Home Assistant with language models to enable natural language control and querying of smart home devices.
Details
- Author
- jango-blockchained
- Repository
- jango-blockchained/advanced-homeassistant-mcp
- GitHub stars
- 14
- Downloads
- 595
- License
- Apache License 2.0
- Categories
- Productivity, Developer Tools, Design, AI, Search
- Tags
- #web
Jump to
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:
docker-compose -f docker-compose.speech.yml up -d
See the Speech Features Guide for detailed configuration and setup instructions.
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Home AssistantCommand (node, npx, python, etc.)bunxArguments-
Argument 1
github:jango-blockchained/advanced-homeassistant-mcp
Environment-
HASS_HOST
http://your-ha-instance:8123 -
HASS_TOKEN
your_long_lived_access_token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
You need a Home Assistant instance and a long-lived access token (create one here).
| 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
---
Minimal setup. Two variables are required:
HASS_HOST=http://homeassistant.local:8123
HASS_TOKEN=eyJ... # long-lived access token
Turn off all lights in the bedroom
Turns off all lights located in the bedroom.
Set the thermostat to 72°F
Sets the thermostat to the specified temperature of 72°F.
Lock all doors and start the vacuum
Locks all doors and initiates the vacuum cleaning process.
Show me energy consumption this week
Displays the energy consumption data for the current week.
What's the temperature in the living room?
Retrieves and shows the current temperature in the living room.
Activate the movie scene
Activates a predefined scene for watching movies, adjusting lights and media.
Notify everyone that dinner is ready
Sends a notification to all connected devices that dinner is ready.
Check my Home Assistant health
Checks the health status of the Home Assistant instance.
Find orphaned devices with low battery
Identifies devices that are orphaned and have low battery levels.
Analyze my light usage patterns
Analyzes and provides insights on the usage patterns of lights.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"home assistant": {
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
},
"args": [
"github:jango-blockchained/advanced-homeassistant-mcp"
],
"command": "bunx"
}
}
}Linux
{
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
},
"args": [
"github:jango-blockchained/advanced-homeassistant-mcp"
],
"command": "bunx"
}Macos
{
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
},
"args": [
"github:jango-blockchained/advanced-homeassistant-mcp"
],
"command": "bunx"
}Windows
{
"env": {
"HASS_HOST": "http://your-ha-instance:8123",
"HASS_TOKEN": "your_long_lived_access_token"
},
"args": [
"/c",
"bunx",
"github:jango-blockchained/advanced-homeassistant-mcp"
],
"command": "cmd"
}🏠 Home Assistant 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
