Provides a flexible interface for Home Assistant device management and automation through a REST API and WebSocket/SSE connections, enabling basic device control, state updates, and automation rule management.

Enables GPU-accelerated speech processing capabilities when using NVIDIA GPUs with CUDA support, improving performance for wake word detection and speech-to-text features.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@HomeAssistant MCP dim the living room lights to 50%"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

# ⚡ Fastest way to try it
bunx github:jango-blockchained/advanced-homeassistant-mcp

{
 "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"
 }
 }
 }
}

{
 "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"
 }
 }
 }
}

{
 "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}"
 }
 }
 }
}

npx @smithery/cli install @jango-blockchained/advanced-homeassistant-mcp --client claude

"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"

docker-compose -f docker-compose.speech.yml up -d

┌──────────────┐ ┌─────────────────────┐ ┌──────────────────┐
│ AI Assistant │◄───►│ Home Assistant │◄───►│ Your Smart Home │
│ (Claude/GPT) │ │ MCP Server │ │ (Home Assistant)│
└──────────────┘ └─────────────────────┘ └──────────────────┘
 │ │
 ┌────┘ └────┐
 ▼ ▼
 ┌────────────┐ ┌──────────────┐
 │ HTTP/WS │ │ STDIO │
 │ (Express) │ │ (fastmcp v3) │
 └────────────┘ └──────────────┘

HASS_HOST=http://homeassistant.local:8123
HASS_TOKEN=eyJ... # long-lived access token

PORT=7123 # HTTP server port (default: 4000)
LOG_LEVEL=info # debug | info | warn | error
JWT_SECRET=... # for HTTP/WS auth (min 32 chars)

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