HA MCP
๐ ๐ค HomeAssistant Add-on for Claude Desktop MCP integration. Control smart home devices, create automations, and manage your home with natural language through Claude.
Ask AI about HA MCP
Powered by Claude ยท Grounded in docs
I know everything about HA MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Home Assistant Claude AI MCP Integration
Connect Claude Desktop to your Home Assistant instance using the Model Context Protocol (MCP).
๐ Features
- Zero-Configuration Setup - Works immediately after installation
- Natural Language Control - Control your entire smart home conversationally
- Full Home Assistant Integration - Access all exposed entities and services
- Secure by Default - OAuth2 authentication and SSL support
- Real-time Communication - Server-Sent Events (SSE) transport
- Multi-Architecture Support - ARM, x86, and more
๐ฆ Installation
Quick Start
-
Add Repository to Home Assistant
Settings โ Add-ons โ Add-on Store โ โฎ โ Repositories Add: https://github.com/mtebusi/ha-mcp -
Install the Add-on
- Find "Claude AI MCP Bridge for Smart Home Control"
- Click Install
- Click Start
-
Connect Claude Desktop
- Open Claude Desktop
- Settings โ Custom Connectors โ Add Remote MCP Server
- Enter:
http://homeassistant.local:8123 - The add-on will be discovered automatically!
๐ฏ Usage
Once connected, you can control your Home Assistant with natural language:
- "Turn on the living room lights"
- "What's the temperature in the bedroom?"
- "Lock all doors"
- "Set the house to night mode"
- "Show me energy usage for today"
๐ Documentation
๐๏ธ Repository Structure
ha-mcp/
โโโ claude-ai-mcp/ # Main Home Assistant add-on
โ โโโ mcp-server/ # TypeScript MCP server implementation
โ โโโ rootfs/ # Add-on filesystem overlay
โ โโโ config.yaml # Add-on configuration
โ โโโ Dockerfile # Container build instructions
โโโ .github/ # GitHub Actions workflows
โโโ repository.yaml # Home Assistant repository metadata
๐ ๏ธ Development
Prerequisites
- Node.js 20+
- TypeScript 5+
- Docker
- Home Assistant development environment
Building Locally
# Clone the repository
git clone https://github.com/mtebusi/ha-mcp.git
cd ha-mcp
# Install dependencies
cd claude-ai-mcp/mcp-server
npm install
# Build TypeScript
npm run build
# Build Docker image
docker build -t claude-ai-mcp claude-ai-mcp/
Testing
# Run TypeScript tests
npm test
# Type checking
npm run type-check
# Linting
npm run lint
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
๐ License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
๐ Acknowledgments
- Home Assistant for the amazing smart home platform
- Anthropic for Claude and the Model Context Protocol
- The Home Assistant community for continuous support and feedback
๐ง Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Community: Home Assistant Community
๐ Links
Made with โค๏ธ for the Home Assistant Community
