✓ Verified 💻 Development ✓ Enhanced Data

Mcp Hass

The skill for control Home Assistant smart home devices and query states using MCP protocol.

Rating: 4.9 (300 reviews)
Downloads: 1,880 downloads
Version: 1.0.0

Overview

The skill for control Home Assistant smart home devices and query states using MCP protocol.

Complete Documentation

View Source →

Home Assistant

Control Home Assistant smart home and query states using MCP protocol.

Prerequisites

Enable MCP server in Home Assistant:

Browse to your Home Assistant instance.
Go to Settings > Devices & services.
In the bottom right corner, select the + Add Integration button.
From the list, select Model Context Protocol.
Follow the instructions on screen to complete the setup.

Usage

shell

# Get states
mcporter call home-assistant.GetLiveContext

# Turn on the device
mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")

# Turn off the device
mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOff(area: "Bedroom", domain: ["light"])

# Control light
# brightness: The percentage of the light, where 0 is off and 100 is fully lit.
# color: Name of color
mcporter call home-assistant.HassLightSet(name: "Bedroom Light", brightness: 50)

# Control fan
# percentage: The percentage of the fan, where 0 is off and 100 is full speed.
mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)

Execute the following command to learn about specific usage methods:

mcporter list home-assistant --schema --all-parameters

Config

When prompted that the MCP server does not exist, remind the user to configure the HASS_BASE_URL and HASS_ACCESS_TOKEN environment variables by executing the following command to add the configuration:

shell

mcporter config add home-assistant \
  --transport http \
  --url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
  --header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"

About `mcporter`

When command mcporter does not exist, use npx -y mcporter instead.
https://github.com/steipete/mcporter/raw/refs/heads/main/docs/call-syntax.md
https://github.com/steipete/mcporter/raw/refs/heads/main/docs/cli-reference.md

Installation

Terminal bash


openclaw install mcp-hass

Copied!

💻Code Examples

## Usage

-usage.sh

# Get states
mcporter call home-assistant.GetLiveContext

# Turn on the device
mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")

# Turn off the device
mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOff(area: "Bedroom", domain: ["light"])

# Control light
# brightness: The percentage of the light, where 0 is off and 100 is fully lit.
# color: Name of color
mcporter call home-assistant.HassLightSet(name: "Bedroom Light", brightness: 50)

# Control fan
# percentage: The percentage of the fan, where 0 is off and 100 is full speed.
mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)

When prompted that the MCP server does not exist, remind the user to configure the `HASS_BASE_URL` and `HASS_ACCESS_TOKEN` environment variables by executing the following command to add the configuration:

when-prompted-that-the-mcp-server-does-not-exist-remind-the-user-to-configure-the-hassbaseurl-and-hassaccesstoken-environment-variables-by-executing-the-following-command-to-add-the-configuration.sh

mcporter config add home-assistant \
  --transport http \
  --url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
  --header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"