About
Advanced Home Assistant MCP is a powerful bridge that connects AI assistants like Claude, GPT-4, and Cursor to your Home Assistant smart home ecosystem. It translates natural language commands into device actions, enabling voice-like control of your entire home through AI chat interfaces. Key capabilities include: - **Lighting control** with brightness, color temperature, RGB colors, and music-synchronized Aurora effects - **Climate management** for thermostats, HVAC modes, fan control, and scheduling - **Automation and scene triggering** to run routines and activate predefined scenes - **Device discovery and status monitoring** with intelligent filtering and search - **Smart home maintenance** with orphaned device detection, energy monitoring, and usage pattern analysis - **Notification system** to send alerts through Home Assistant's channels - **Intelligent scenario detection** for identifying energy waste, window/heating conflicts, and nobody-home situations - **Enterprise-grade security** with JWT authentication, rate limiting, and input sanitization
Tools 13
lights_controlControl lights in Home Assistant. List all lights, get state of a specific light, turn lights on with brightness/color settings, or turn lights off.
climate_controlControl climate devices (thermostats, AC) in Home Assistant. List devices, get state, set HVAC mode, temperature, or fan mode.
list_devicesList all available Home Assistant devices with optional filtering by domain, area, or floor.
cover_controlControl covers (blinds, curtains, garage doors). Open, close, stop, or set position.
media_player_controlControl media players. Play, pause, stop, volume control, and source selection.
fan_controlControl fans. Turn on/off, set speed percentage, preset modes, oscillation.
lock_controlControl locks. Lock, unlock, or open (for locks that support unlatching).
vacuum_controlControl robot vacuums. Start, pause, stop, return to dock, clean spot, locate.
alarm_controlControl alarm systems. Arm (home, away, night), disarm, or trigger alarms.
automationManage Home Assistant automations. List all automations, toggle on/off, or trigger manually.
sceneManage and activate Home Assistant scenes.
notifySend notifications through Home Assistant notification services.
system_infoGet information about the MCP server including version and Home Assistant connection status.
README
🏠 Home Assistant MCP
[](https://smithery.ai/server/@jango-blockchained/advanced-homeassistant-mcp) [](LICENSE) [](https://www.npmjs.com/package/@jango-blockchained/homeassistant-mcp) [](https://github.com/jango-blockchained/advanced-homeassistant-mcp/pkgs/container/advanced-homeassistant-mcp) [](https://bun.sh) [](https://www.typescriptlang.org)
> 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
🛡️ Enterprise-Grade Security
⚡ High-Performance Architecture
🏠 Comprehensive Device Control
---
🚀 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 installConfigure 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
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 claudeInstall to Cursor
npx @smithery/cli install @jango-blockchained/homeassistant-mcp --client cursorInstall to VS Code
npx @smithery/cli install @jango-blockchained/homeassistant-mcp --client vscode
You'll be prompted to configure:
See SMITHERY_DEPLOYMENT.md for detailed deployment guide.
Option 2: NPX (Quick Start)
npx @jango-blockchained/homeassistant-mcp@latest
Option 3: Bunx with GitHub (No NPM Login Required)
If you can't login to npm, use Bunx to run directly from GitHub:
# Install Bun first if you don't have it
curl -fsSL https://bun.sh/install | bashThen run from GitHub
bunx github:jango-blockchained/advanced-homeassistant-mcp
Alternatively, install directly from Git:
bun add git+https://github.com/jango-blockchained/advanced-homeassistant-mcp.git
homeassistant-mcp
Option 4: Docker (Containerized)
Run the MCP server in a Docker container:
```bash
Pull the latest image
docker pull ghcr.io/jango-blockchained/advanced-homeassistant-mcp:latestRun with environment variables
docker run -d \ -e HOME_ASSISTANT_URL=http://your-ha-instance:8123 \ -e HOME_ASSISTANT_TOKEN=your_lonRelated MCP Servers
AI Research Assistant
hamid-vakilzadeh
AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar
Linkup
LinkupPlatform
Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages
Math-MCP
EthanHenrickson
Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support