# Send 🏠 Home Assistant via MCP protocol to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mcp-hass",
    "name": "🏠 Home Assistant via MCP protocol",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/al-one/mcp-hass",
    "canonicalUrl": "https://clawhub.ai/al-one/mcp-hass",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mcp-hass",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mcp-hass",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mcp-hass"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mcp-hass",
    "downloadUrl": "https://openagent3.xyz/downloads/mcp-hass",
    "agentUrl": "https://openagent3.xyz/skills/mcp-hass/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mcp-hass/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mcp-hass/agent.md"
  }
}
```
## Documentation

### 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 mcporter does not exist, use npx -y mcporter instead.
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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: al-one
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mcp-hass)
- [Send to Agent page](https://openagent3.xyz/skills/mcp-hass/agent)
- [JSON manifest](https://openagent3.xyz/skills/mcp-hass/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mcp-hass/agent.md)
- [Download page](https://openagent3.xyz/downloads/mcp-hass)