mcpField
O
openclaw-homeassistant

openclaw-homeassistant

github.com/homeofeOther41 installs
Repository

About openclaw-homeassistant

openclaw-homeassistant is an OpenClaw plugin for controlling Home Assistant devices and inspecting smart-home state through chat. It offers domain-specific controls alongside general service and event operations, with read-only and domain restrictions.

Key features

  1. 01Inspect entities, states, and history
  2. 02Control lights, switches, and climate
  3. 03Manage media players and covers
  4. 04Run scenes, scripts, and automations
  5. 05Restrict writes and allowed domains

Use cases

  1. 01Check sensor readings and device states
  2. 02Adjust lights or thermostat from chat
  3. 03Trigger a scene or automation
  4. 04Limit plugin access to selected domains

MCP support

The README describes Home Assistant tools exposed by an OpenClaw plugin, but does not state that the plugin uses MCP.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/homeofe/openclaw-homeassistant --skill openclaw-homeassistant

After installing, type/openclaw-homeassistantin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CODE_OF_CONDUCT.md
LICENSE
.gitignore
README.md
CONTRIBUTING.md
SECURITY.md
openclaw.plugin.json
package.json
package-lock.json
.ai/handoff/
DASHBOARD.md
LOG.md
NEXT_ACTIONS.md
MANIFEST.json
STATUS.md
.ai/handoff/research/
T-002-home-assistant-js-websocket.md
T-004-architecture-decision.md
T-003-existing-ha-ai-integrations.md
.ai/research/
T-001-ha-api-research.md
.github/
PULL_REQUEST_TEMPLATE.md
dependabot.yml
.github/ISSUE_TEMPLATE/
bug_report.md
feature_request.md
.github/workflows/
auto-publish.yml
codeql.yml
dashboard/
akido-dashboard.yaml
src/
config.ts
client.ts
guards.ts
src/__tests__/
client.test.ts
config.test.ts

Details

From the project README

openclaw-homeassistant

OpenClaw plugin for Home Assistant integration. Control your entire smart home from chat.

Tools (34)

Core
  • ha_status - HA config, version, location
  • ha_list_entities - List entities (filter by domain/state)
  • ha_get_state - Get single entity state + attributes
  • ha_search_entities - Search entities by name pattern
  • ha_list_services - Available services by domain
Lights
  • ha_light_on - Turn on (brightness, color_temp, rgb, transition)
  • ha_light_off / ha_light_toggle
  • ha_light_list - All lights with current state
Switches
  • ha_switch_on / ha_switch_off / ha_switch_toggle
Climate
  • ha_climate_set_temp - Set temperature + HVAC mode
  • ha_climate_set_mode - heat/cool/auto/off
  • ha_climate_set_preset - home/away/eco/boost
  • ha_climate_list - All climate entities with temps
Media Player
  • ha_media_play / ha_media_pause / ha_media_stop
  • ha_media_volume - Set volume (0.0-1.0)
  • ha_media_play_media - Play specific media
Covers
  • ha_cover_open / ha_cover_close
  • ha_cover_position - Set position (0-100)
Scenes & Automations
  • ha_scene_activate / ha_script_run / ha_automation_trigger
Sensors & History
  • ha_sensor_list - All sensors with values
  • ha_history - Entity history over time
  • ha_logbook - Recent logbook entries
Generic
  • ha_call_service - Any service call
  • ha_fire_event - Fire custom events
  • ha_render_template - Jinja2 templates
Notifications
  • ha_notify - Send notifications

Configuration

{
  "url": "http://your-ha-instance:8123",
  "token": "YOUR_LONG_LIVED_ACCESS_TOKEN",
  "allowedDomains": ["light", "switch", "climate"],
  "readOnly": false
}

Safety

  • readOnly: blocks all write operations
  • allowedDomains: restricts to specific device domains
  • Entity ID validation enforced on all calls

Comments

Markdown supported