MCP HA Extended

A Model Context Protocol (MCP) server that extends Home Assistant capabilities to support automation management. Available as both a standalone Python application and a Home Assistant addon.

Features

• ✅ List all automations

• ✅ Get automation details

• ✅ Create new automations from YAML

• ✅ Update existing automations

• ✅ Delete automations

• ✅ Trigger automations manually

• ✅ Enable/disable automations

Quick Start

As a Home Assistant Addon (Recommended)

1. Add repository: https://github.com/rios0rios0/mcp-home-assistant-extended

2. Install "MCP HA Extended" from the addon store

3. Configure with your Home Assistant URL and access token

4. Use with any MCP-compatible client (like Cursor IDE)

See Addon Installation Guide for detailed instructions.

As a Standalone Python Application

1. Install dependencies: pdm install

2. Set environment variables: HA_URL and HA_TOKEN

3. Run: pdm run python -m mcp_ha_extended.server

4. Configure your MCP client to use the server

See Quick Start Guide for a 5-minute setup, or Setup Guide for detailed instructions.

Documentation

All documentation is organized in the .docs folder:

• Documentation Index - Start here for navigation

• Quick Start - Get running in 5 minutes

• Addon Installation - Install as Home Assistant addon

• Setup Guide - Detailed development setup

• Usage Examples - Code examples and use cases

• Implementation Guide - Technical details

Architecture

Requirements

• Python 3.10+

• Home Assistant instance with REST API enabled

• Long-lived access token from Home Assistant

• MCP-compatible client (e.g., Cursor IDE)

Installation Methods

Option 1: Home Assistant Addon (Recommended)

Easiest installation method. The addon is automatically built and published to GitHub Container Registry.

Repository: https://github.com/rios0rios0/mcp-home-assistant-extended

See Addon Installation Guide for details.

Option 2: Standalone Python Application

For development or when you don't want to use Home Assistant addons.

See Setup Guide for installation instructions.

MCP Tools

Once configured, you'll have access to these tools:

1. list_automations - List all automations

2. get_automation - Get details of a specific automation

3. create_automation - Create a new automation from YAML

4. update_automation - Update an existing automation

5. delete_automation - Delete an automation

6. trigger_automation - Manually trigger an automation

7. enable_automation - Enable an automation

8. disable_automation - Disable an automation

See Usage Examples for detailed examples.

Development

Prerequisites

• Python 3.10+

• PDM for dependency management

Setup

See Setup Guide and PDM Setup for more details.

Building the Addon

The addon is automatically built via GitHub Actions. See Addon Build Guide for manual build instructions and GitHub Actions setup.

Contributing

Contributions are welcome! Please read the Implementation Guide to understand the architecture before contributing.

License

MIT License - see LICENSE file for details.

Links

• GitHub Repository: https://github.com/rios0rios0/mcp-home-assistant-extended

• Container Registry: ghcr.io/rios0rios0/mcp-home-assistant-extended

• Documentation: .docs/SUMMARY.md

Support

• Check the troubleshooting sections in the documentation

• Review Usage Examples for common patterns

• Open an issue on GitHub for bugs or feature requests