# 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.

- **Type:** MCP server
- **Install:** `agentstack add mcp-mtebusi-ha-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mtebusi](https://agentstack.voostack.com/s/mtebusi)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [mtebusi](https://github.com/mtebusi)
- **Source:** https://github.com/mtebusi/HA_MCP
- **Website:** https://github.com/mtebusi/HA_MCP/releases

## Install

```sh
agentstack add mcp-mtebusi-ha-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Home Assistant Claude AI MCP Integration

[](https://github.com/mtebusi/ha-mcp/actions/workflows/builder.yaml)
[](https://github.com/mtebusi/ha-mcp/actions/workflows/lint.yaml)
[](https://github.com/mtebusi/ha-mcp/releases)
[](LICENSE)

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

1. **Add Repository to Home Assistant**
   ```
   Settings → Add-ons → Add-on Store → ⋮ → Repositories
   Add: https://github.com/mtebusi/ha-mcp
   ```

2. **Install the Add-on**
   - Find "Claude AI MCP Bridge for Smart Home Control"
   - Click Install
   - Click Start

3. **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

- [Add-on Documentation](claude-ai-mcp/DOCS.md)
- [Changelog](claude-ai-mcp/CHANGELOG.md)
- [Configuration Guide](claude-ai-mcp/DOCS.md#configuration-options-all-optional)

## 🏗️ 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

```bash
# 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

```bash
# 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.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📝 License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [Home Assistant](https://www.home-assistant.io/) for the amazing smart home platform
- [Anthropic](https://www.anthropic.com/) for Claude and the Model Context Protocol
- The Home Assistant community for continuous support and feedback

## 📧 Support

- **Issues**: [GitHub Issues](https://github.com/mtebusi/ha-mcp/issues)
- **Discussions**: [GitHub Discussions](https://github.com/mtebusi/ha-mcp/discussions)
- **Community**: [Home Assistant Community](https://community.home-assistant.io/)

## 🔗 Links

- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
- [Home Assistant Add-on Development](https://developers.home-assistant.io/docs/add-ons/)
- [Claude Desktop](https://claude.ai/desktop)

---

Made with ❤️ for the Home Assistant Community

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mtebusi](https://github.com/mtebusi)
- **Source:** [mtebusi/HA_MCP](https://github.com/mtebusi/HA_MCP)
- **License:** Apache-2.0
- **Homepage:** https://github.com/mtebusi/HA_MCP/releases

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-mtebusi-ha-mcp
- Seller: https://agentstack.voostack.com/s/mtebusi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.