mcp-home-assistant-extended

rios0rios0/mcp-home-assistant-extended

3.2

If you are the rightful owner of mcp-home-assistant-extended and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This is a custom MCP server that extends Home Assistant capabilities to support creating, editing, and listing automations.

Tools
8
Resources
0
Prompts
0

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 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 for a 5-minute setup, or for detailed instructions.

Documentation

All documentation is organized in the folder:

  • - Start here for navigation
  • - Get running in 5 minutes
  • - Install as Home Assistant addon
  • - Detailed development setup
  • - Code examples and use cases
  • - Technical details

Architecture

┌─────────────────┐
│   MCP Client    │  (e.g., Cursor IDE)
│                 │
└────────┬────────┘
         │ MCP Protocol
         │
┌────────▼─────────────────────────┐
│  MCP HA Extended Server          │
│  (Python - this project)         │
└────────┬─────────────────────────┘
         │ HTTP REST API
         │
┌────────▼────────┐
│ Home Assistant   │
│ REST API        │
│ /api/automation │
└─────────────────┘

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 for details.

Option 2: Standalone Python Application

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

See 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 for detailed examples.

Development

Prerequisites

  • Python 3.10+
  • PDM for dependency management

Setup

# Install dependencies
pdm install

# Run tests
pdm run pytest

# Run the server
pdm run python -m mcp_ha_extended.server

See and for more details.

Building the Addon

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

Contributing

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

License

MIT License - see file for details.

Links

Support

  • Check the in the documentation
  • Review for common patterns
  • Open an issue on GitHub for bugs or feature requests