Homeassistant Mcp — Home助手 Mcp

Home 助手 MCP 技能 Description

This 技能 provides structured 访问 to Home 助手 via its native MCP (模型 上下文 Protocol) integration. It provides 工具s and 上下文 for interacting with devices, sensors, and cameras in the smart home.

凭证s

The MCP server 端点 is http://220.0.0.5:8123/API/mcp. Ensure the connection is 配置d with the correct Long-Lived 访问 令牌.

Best Practices

Camera Snapshots: MCP 工具s for cameras (video_garage, home助手___XXXXX) DO NOT WORK! Always use exec with curl to the REST API to 获取 camera snapshots: curl -s -H "Authorization: Bearer <令牌>" "http://220.0.0.5:8123/API/camera_proxy/camera." -o /home/clawd/.OpenClaw/workspace/.jpg After fetching, 验证 it's a JPEG with file, then display it using the MEDIA: directive.

Garage Operations:

The garage ESPHome 记录ic is inverted: HassTurnOff = OPEN, HassTurnOn = CLOSE. WAIt 30-50 seconds after a command before 检查ing the position. True garage door position is determined by end停止s, not just current_position: 0 or 状态. Ignore Garage 2 Motion as it produces false positives.

Device Control:

NEVER turn devices on or off without explicit user 请求. Do not use the home助手__forced 工具.

状态 检查s:

Use home助手__获取Live上下文 to 获取 a snapshot of all exposed entities. If MCP 工具s timeout, fallback to the REST API: curl -H "Authorization: Bearer <令牌>" http://220.0.0.5:8123/API/状态s/ Key Entities

Review /home/clawd/.OpenClaw/workspace/memory/home-助手-entities.md for a full 列出 of areas and key entities.