home / mcp / mcp home assistant extended server

MCP Home Assistant Extended Server

Provides an MCP bridge to manage Home Assistant automations via MCP clients with list, create, update, delete, trigger, and enable/disable capabilities.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rios0rios0-mcp-home-assistant-extended": {
      "command": "pdm",
      "args": [
        "run",
        "python",
        "-m",
        "mcp_ha_extended.server"
      ],
      "env": {
        "HA_URL": "YOUR_HOME_ASSISTANT_URL",
        "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
      }
    }
  }
}

MCP HA Extended is a server that lets you manage Home Assistant automations from any MCP-compatible client. You can list, inspect, create from YAML, update, delete, trigger, and enable or disable automations, all through a unified MCP interface. This makes automations easier to manage from external tools and scripts while keeping Home Assistant in sync.

How to use

You connect your MCP client to the MCP HA Extended server and perform common automation actions through dedicated endpoints. Typical workflows include listing all automations to see what exists, inspecting a specific automation to review its YAML and metadata, creating a new automation from YAML, updating an existing automation, deleting an automation you no longer need, and triggering or toggling automations on and off.

How to install

Prerequisites you need before you begin:

Python 3.10+

Home Assistant REST API enabled

Long-lived access token

MCP-compatible client

Option A — Home Assistant Addon (Recommended)

Use the MCP HA Extended addon to simplify installation and updates. Follow these steps to install the addon and configure it to talk to your Home Assistant instance.

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)

Option B — Standalone Python Application

If you prefer running outside of Home Assistant, you can run the server as a standalone Python app. Use the following steps to set up and start the server.

1. Install dependencies
pdm install

2. Set environment variables
HA_URL=your_home_assistant_url
HA_TOKEN=your_long_lived_token

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

4. Configure your MCP client to use the server

What to do after installation

Once the server is running, point your MCP client to the server and start using the tools to manage automations. You can list automations, view details, create new automations from YAML, update existing ones, delete automations, and trigger or enable/disable automations as needed.

Available tools

list_automations

List all automations available in Home Assistant via the MCP bridge.

get_automation

Retrieve detailed information about a specific automation by its identifier.

create_automation

Create a new automation using YAML content supplied by the MCP client.

update_automation

Update an existing automation with new YAML or metadata.

delete_automation

Remove an automation from Home Assistant via MCP.

trigger_automation

Manually trigger an automation on demand.

enable_automation

Enable an automation that has been disabled.

disable_automation

Disable an automation without deleting it.