🏠 Home Assistant MCP

Bridge the gap between AI assistants and your smart home 🚀

A powerful, secure, and extensible Model Context Protocol (MCP) server that enables AI assistants like Claude, GPT, and Cursor to seamlessly interact with Home Assistant. Control your lights, climate, automations, and more through natural language commands.

✨ Feature Overview

🤖 AI-Powered Smart Home Control

• Natural Language Processing: Turn "dim the living room lights to 50%" into actual device commands
• Multi-Assistant Support: Works with Claude, GPT-4, Cursor, and other MCP-compatible assistants
• Intelligent Context: Remembers device states, relationships, and user preferences
• Smithery Integration: One-click installation and deployment via Smithery.ai

🛡️ Enterprise-Grade Security

• Rate Limiting: Protects against abuse with configurable request limits
• Input Sanitization: Prevents XSS and injection attacks
• JWT Authentication: Secure token-based access control
• Security Headers: Comprehensive protection against web vulnerabilities

⚡ High-Performance Architecture

• Bun Runtime: 4x faster than Node.js with built-in TypeScript support
• Streaming Responses: Real-time updates for long-running operations
• Modular Design: Clean separation of concerns with extensible plugin system
• Multiple Transports: HTTP REST API, WebSocket, and Standard I/O support

🏠 Comprehensive Device Control

• Lighting Control: Brightness, color temperature, RGB colors, and effects
• Climate Management: Thermostats, HVAC modes, fan control, and scheduling
• Automation & Scenes: Trigger automations, activate scenes, and manage routines
• Device Discovery: Intelligent device listing with filtering and search
• Notification System: Send alerts through Home Assistant's notification channels
• Smart Maintenance: Find orphaned devices, analyze usage patterns, energy monitoring
• Intelligent Scenarios: Auto-detect and manage nobody-home, window/heating conflicts, energy waste

🚀 Quick Start

Get up and running in minutes:

# Clone and install
git clone https://github.com/jango-blockchained/advanced-homeassistant-mcp.git
cd advanced-homeassistant-mcp
bun install

# Configure environment
cp .env.example .env
# Edit .env with your Home Assistant details

# Start the server
bun run start:stdio

That's it! Your AI assistant can now control your smart home. 🤖✨

📦 Installation

Prerequisites

• 🚀 Bun (v1.0.26+) - Recommended
• 🏠 Home Assistant instance

Option 1: Smithery.ai (Recommended for Quick Setup)

Smithery is a registry for MCP servers that makes installation incredibly easy:

# Install to Claude Desktop
npx @smithery/cli install @jango-blockchained/homeassistant-mcp --client claude

# Install to Cursor
npx @smithery/cli install @jango-blockchained/homeassistant-mcp --client cursor

# Install to VS Code
npx @smithery/cli install @jango-blockchained/homeassistant-mcp --client vscode

You'll be prompted to configure:

• Home Assistant URL
• Long-lived access

... View full README on GitHub