โ Back to Skills Marketplace
About
๐ Home Assistant via MCP protocol
by
Alone
ยท GitHub โ
ยท v1.0.1
5072
Downloads
10
Stars
26
Active Installs
2
Versions
Install in OpenClaw
/install mcp-hass
Description
The skill for control Home Assistant smart home devices and query states using MCP protocol.
README (SKILL.md)
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
# 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:
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
mcporterdoes not exist, usenpx -y mcporterinstead. - 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
Usage Guidance
Install only if you want an agent to access Home Assistant. Use a dedicated, least-privileged token where possible, review commands that change device state, and be especially careful with locks, alarms, heaters, garage doors, appliances, or other safety-relevant devices.
Capability Analysis
Type: OpenClaw Skill
Name: mcp-hass
Version: 1.0.1
The skill is designed to control Home Assistant devices using the `mcporter` tool. All instructions in `SKILL.md` are consistent with this stated purpose, detailing setup, usage, and configuration. It requires `HASS_ACCESS_TOKEN` and `HASS_BASE_URL` environment variables, which are used legitimately for authentication and connectivity to Home Assistant, not for exfiltration. There is no evidence of malicious execution, persistence, data theft, or prompt injection attempts against the agent beyond the skill's stated functionality.
Capability Assessment
Purpose & Capability
The stated purpose is Home Assistant control via MCP, and the documented commands match that purpose, including reading live context and changing lights or fans.
Instruction Scope
The instructions are straightforward setup and command examples; they would benefit from clearer confirmation guidance before changing real device state.
Install Mechanism
The skill declares a Node install for mcporter and allows npx fallback, which is coherent with the MCP workflow, though the dependency is not pinned in the artifact.
Credentials
HASS_BASE_URL and HASS_ACCESS_TOKEN are sensitive but expected for Home Assistant API access, and the artifact uses them only for the Home Assistant MCP endpoint and authorization header.
Persistence & Privilege
The mcporter config command persistently registers the Home Assistant MCP server with an authorization header placeholder; this is disclosed and purpose-aligned.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mcp-hass - After installation, invoke the skill by name or use
/mcp-hass - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added homepage and metadata fields to the skill, including requirements and install instructions.
- Updated all example commands to use mcporter directly, with a note to use npx if mcporter is not installed.
- Improved documentation by clarifying tool usage and environment variable setup.
- Enhanced guidance for installation and configuration steps.
v1.0.0
Initial release of mcp-hass skill.
- Control Home Assistant devices and query states using the MCP protocol.
- Provides command examples for turning devices on/off and adjusting lights/fans.
- Includes setup instructions for integrating MCP server into Home Assistant.
- Explains configuration of required environment variables for connection.
- Recommends using npx for running mcporter commands.
- Documentation includes command references and usage tips.
Metadata
Frequently Asked Questions
What is ๐ Home Assistant via MCP protocol?
The skill for control Home Assistant smart home devices and query states using MCP protocol. It is an AI Agent Skill for Claude Code / OpenClaw, with 5072 downloads so far.
How do I install ๐ Home Assistant via MCP protocol?
Run "/install mcp-hass" in the OpenClaw or Claude Code chat to install it in one step โ no extra setup required.
Is ๐ Home Assistant via MCP protocol free?
Yes, ๐ Home Assistant via MCP protocol is completely free (open-source). You can download, install and use it at no cost.
Which platforms does ๐ Home Assistant via MCP protocol support?
๐ Home Assistant via MCP protocol is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ๐ Home Assistant via MCP protocol?
It is built and maintained by Alone (@al-one); the current version is v1.0.1.
More Skills