← 返回 Skills 市场

Homeassistant Mcp

Name: Homeassistant Mcp
Author: dsnkzdeny

作者 dsnkzdeny · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install homeassistant-mcp

功能描述

Provides structured access to Home Assistant devices, sensors, and cameras via MCP, with specific handling for cameras, garage doors, and device control.

使用说明 (SKILL.md)

Home Assistant MCP Skill

Description

This skill provides structured access to Home Assistant via its native MCP (Model Context Protocol) integration. It provides tools and context for interacting with devices, sensors, and cameras in the smart home.

Credentials

The MCP server endpoint is http://220.0.0.5:8123/api/mcp. Ensure the connection is configured with the correct Long-Lived Access Token.

Best Practices

Camera Snapshots: MCP tools for cameras (video_garage, homeassistant___XXXXX) DO NOT WORK! Always use exec with curl to the REST API to get camera snapshots: curl -s -H "Authorization: Bearer \x3CTOKEN>" "http://220.0.0.5:8123/api/camera_proxy/camera.\x3Centity_id>" -o /home/clawd/.openclaw/workspace/\x3Cfilename>.jpg After fetching, verify it's a JPEG with file, then display it using the MEDIA:\x3Cpath> directive.
Garage Operations:
- The garage ESPHome logic is inverted: HassTurnOff = OPEN, HassTurnOn = CLOSE.
- Wait 30-50 seconds after a command before checking the position.
- True garage door position is determined by endstops, not just current_position: 0 or state.
- Ignore Garage 2 Motion as it produces false positives.
Device Control:
- NEVER turn devices on or off without explicit user request.
- Do not use the homeassistant__forced tool.
Status Checks:
- Use homeassistant__GetLiveContext to get a snapshot of all exposed entities.
- If MCP tools timeout, fallback to the REST API: curl -H "Authorization: Bearer \x3CTOKEN>" http://220.0.0.5:8123/api/states/\x3Centity_id>

Key Entities

Review /home/clawd/.openclaw/workspace/memory/home-assistant-entities.md for a full list of areas and key entities.

安全使用建议

Install only if you recognize and control the Home Assistant endpoint shown in the skill. Before using it, confirm the token, network path, and entity memory file are safe, and require explicit user confirmation for any device or garage-door operation.

功能分析

Type: OpenClaw Skill Name: homeassistant-mcp Version: 1.0.0 The skill instructions in SKILL.md direct the AI agent to bypass standard MCP tools and instead use the 'exec' capability to run 'curl' commands for camera snapshots and status checks. This pattern involves handling sensitive Long-Lived Access Tokens within shell commands and writing files to the workspace, which increases the risk of token exposure and command injection. While these instructions appear to be functional workarounds for technical limitations, the reliance on raw shell execution for API interactions at the IP 220.0.0.5 is a high-risk practice.

能力标签

requires-oauth-tokenrequires-sensitive-credentials

能力评估

ℹ Purpose & Capability

The Home Assistant device, sensor, camera, and garage-door capabilities match the stated purpose, but they include sensitive camera access and physical-device control.

⚠ Instruction Scope

The instructions tell the agent to use exec/curl REST calls with a bearer token as a fallback or replacement for MCP tools, which is a broad escape hatch for a sensitive smart-home integration.

ℹ Install Mechanism

This is instruction-only with no code or install script. However, registry metadata declares no primary credential or required env var while SKILL.md requires a Home Assistant Long-Lived Access Token.

⚠ Credentials

The Home Assistant endpoint is hard-coded as an HTTP address rather than a user-configured, clearly private, or HTTPS endpoint, making the credential and data boundary hard to verify.

ℹ Persistence & Privilege

No background persistence code is present, but the skill relies on a long-lived token and a persistent local memory file containing Home Assistant entity information.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install homeassistant-mcp
安装完成后，直接呼叫该 Skill 的名称或使用 /homeassistant-mcp 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Home Assistant MCP Skill 1.0.0 - Initial release providing structured access to Home Assistant via Model Context Protocol (MCP). - Enables interaction with devices, sensors, and cameras in the smart home environment. - Documents credential setup using server endpoint and access token. - Clarifies camera snapshot handling with REST API instead of MCP tools. - Notes specific logic for garage door operations and position checks. - Outlines device control best practices and fallback methods for status checks. - References external documentation for a complete entity list.

元数据

Slug homeassistant-mcp

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题