A bridge for AI agents to interact with Home Assistant devices and states via the Model Context Protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mcp-hass
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mcp-hass using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Home Assistant (mcp-hass)?
The mcp-hass skill provides a robust interface for AI agents to communicate with a Home Assistant ecosystem using the Model Context Protocol (MCP). By utilizing the mcporter utility, this skill allows your AI assistant to not only query the live state of your home environment but also to actively control devices such as lights, fans, and switches. It is an essential component for developers building local automation logic within the framework of Openclaw Skills.
This integration empowers AI agents to understand the physical context of their surroundings. Whether you are looking to automate your office lighting based on your development workflow or monitor sensor data during long-running builds, this skill translates natural intent into precise smart home actions.
Home Assistant (mcp-hass) Use Cases
- Automating home office lighting and climate control through terminal commands.
- Querying real-time sensor data to trigger alerts or developer notifications.
- Integrating physical device status into broader AI-driven workflows using Openclaw Skills.
- Creating custom dashboards that aggregate smart home states via AI-generated reports.
How Home Assistant (mcp-hass) Works
- The user enables the MCP server integration within their Home Assistant instance to expose the API.
- The mcporter tool is installed via Node.js to act as the communication client.
- Environment variables for HASS_BASE_URL and HASS_ACCESS_TOKEN are configured to authorize the connection.
- The AI agent executes mcporter calls which are translated into MCP requests to the Home Assistant instance.
- Home Assistant processes the request and returns the device state or confirms the action to the agent.
Home Assistant (mcp-hass) Setup
Ensure you have Node.js installed, then install the mcporter utility if it is not already available:
npx -y mcporter install
Configure your Home Assistant connection by adding the configuration to mcporter. Replace the environment variables with your specific Home Assistant URL and Long-Lived Access Token:
mcporter config add home-assistant \
--transport http \
--url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
--header "Authorization=Bearer ${HASS_ACCESS_TOKEN}"
Ensure that the Model Context Protocol integration is also enabled in your Home Assistant UI under Settings > Devices & Services.
Home Assistant (mcp-hass) Data Schema & Taxonomy
The skill organizes its operations through standard MCP tool definitions. Below are the primary methods available for interacting with Openclaw Skills for Home Assistant:
| Tool Name | Purpose | Key Parameters |
|---|---|---|
GetLiveContext |
Fetches the current state of all tracked entities | N/A |
HassTurnOn |
Powers on a specific entity, area, or domain | name, area, domain |
HassTurnOff |
Powers off a specific entity, area, or domain | name, area, domain |
HassLightSet |
Configures brightness and color for lights | brightness, color, name |
HassFanSetSpeed |
Controls fan speed percentages | percentage, name, area |
Home Assistant (mcp-hass) Advanced Features
- Dynamic schema discovery using
mcporter list home-assistant --schema --all-parametersto find hidden device capabilities. - Multi-domain targeting allowing for bulk operations across different device types (e.g., turning off all lights in a specific area).
- Support for custom headers and transport configurations to secure connections to remote Home Assistant instances.
- Compatibility with the broader ecosystem of Openclaw Skills to enable complex cross-platform automation.
SKILL.md
Loading
Related Openclaw Skills
edge-tts-uvx
A high-fidelity text-to-speech engine leveraging Microsoft Edge's neural voices for natural-sounding audio generation.
Audio Transcription Skill
A high-performance local audio transcription tool powered by faster-whisper for seamless speech-to-text processing.
Polygon PoS Development Skill
A comprehensive toolkit for building, testing, and deploying smart contracts on the Polygon PoS network using the Foundry framework.
LLM Wallet - Crypto & Micropayments
A specialized tool for managing crypto wallets and facilitating x402-based USDC micropayments on the Polygon network for AI agents.
MCP Lark / FeiShu Integration
A powerful bridge connecting AI agents to the Lark and FeiShu ecosystem via the Model Context Protocol (MCP).
mcp-vods
A versatile media discovery skill that enables AI agents to find video content and cast it directly to smart TVs.
METADATA
Featured*
