Agent Skills
› NeverSight/learn-skills.dev
› mcp-hass
mcp-hass
GitHub通过 MCP 协议控制 Home Assistant 智能家居设备并查询状态。支持开关设备、调节灯光亮度与颜色、设置风扇转速，以及获取实时上下文。需预先配置环境变量和集成。
Trigger Scenarios
用户请求打开或关闭智能设备
用户询问家中设备当前状态
用户要求调节灯光或风扇参数
Install
npx skills add NeverSight/learn-skills.dev --skill mcp-hass -g -y
SKILL.md
Frontmatter
{
"name": "mcp-hass",
"description": "The skill for control Home Assistant smart home devices and query states using MCP protocol."
}
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.
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:
npx -y mcporter config add home-assistant \
--transport http \
--url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
--header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"
Usage
# Get states
npx -y mcporter call home-assistant.GetLiveContext
# Turn on the device
npx -y mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")
npx -y mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")
# Turn off the device
npx -y mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")
npx -y 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
npx -y 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.
npx -y mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)
Execute the following command to learn about specific usage methods:
npx -y mcporter list home-assistant --schema --all-parameters
About mcporter
- To improve compatibility, use
npx -y mcporterinstead ofmcporterwhen executing commands. - 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
Version History
- e0220ca Current 2026-07-05 22:04
