Simplifies interaction with Home Assistant MCP tools.

Install

mkdir -p .claude/skills/ha-mcp-tools && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14745" && unzip -o skill.zip -d .claude/skills/ha-mcp-tools && rm skill.zip

Installs to .claude/skills/ha-mcp-tools

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use when choosing which ha-mcp tool or action to call. Examples: \"How do I list entities?\", \"create a helper\", \"turn on a light\", \"find devices in kitchen\", \"which action should I use?\".
196 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Control devices by turning them on, off, or toggling
  • Retrieve the current state of a single entity
  • List entities by area, domain, or state
  • Manage automations by creating, editing, or deleting them
  • Create various types of helpers like input or timer
  • Rename entities in the registry

How it works

This skill maps user intents to specific ha-mcp tools and actions, providing a reference for controlling Home Assistant devices and managing its configuration.

Inputs & outputs

You give it
User intent for a Home Assistant action
You get back
The appropriate ha-mcp tool and action to execute

When to use ha-mcp-tools

  • List home entities
  • Find kitchen devices
  • Turn on lights

About this skill

ha-mcp Tool Discovery

Intent → Tool

User intentTool + Action
Turn on / off / toggle a devicecall_service (domain=light/switch, service=turn_on/turn_off/toggle)
Get a single entity's current stateget_state
List entities in an area / by domain / by statequery_entities mode=current
Find unavailable / stale / disabled entitiesquery_entities mode=health
Person / device tracker presence (home/away)query_entities mode=presence
Historical state for a sensor over timequery_entities mode=history
Aggregated stats (min/max/mean) for a sensorquery_entities mode=statistics
Which entity domains exist in this HA instance?query_entities mode=domains
Device health (orphaned / config errors)query_devices mode=health
Where is entity X used? (automations, scripts, scenes, dashboards, template helpers)analyze_entity — returns RFC 6901 paths to each reference location; scanned_sources lists what was actually searched
Which entities does automation X depend on?get_entity_dependencies
Find a string/entity_id across ALL config types in one callfind_references — automations/scripts/scenes/dashboards/helper templates, match_mode substring/exact
Create / edit / delete an automationmanage_automation action=create/update/delete
Toggle / enable / disable an automationmanage_automation action=toggle
See automation trigger/condition/service coveragemanage_automation action=coverage
Add/remove a trigger or condition (surgical edit)manage_automation action=patch (semantic op)
Run a scriptmanage_script action=execute
Activate a scenemanage_scene action=activate
Create a helper (input, timer, counter, etc.)manage_helper action=create
Set / toggle / start a helper value at runtimehelper_action
Rename an entity in the registrymanage_entity action=update (new_entity_id field)
Assign an entity to an areamanage_entity action=update (area_id field)
Add / remove labels on entity or devicemanage_entity / manage_device action=update + label_mode
List / create / rename an areamanage_area action=list/create/update
Check what config entries exist for an integrationmanage_config_entry action=list (domain filter)
Browse available serviceslist_services
Render a Jinja2 templaterender_template
Get logbook entries / cause-effect correlationget_logbook mode=entries/correlation
Check HA version / timezoneget_system_info
Validate configuration.yamlvalidate_config
Manage a dashboard (create / edit / view)manage_dashboard
Locate content in a large dashboard (avoid size-limit errors)manage_dashboard action=find search=<string/entity_id>
Install / uninstall a HACS add-onmanage_hacs action=download/uninstall
View automation / script execution tracemanage_trace action=list/get
Import a blueprintmanage_blueprint action=import
Check for HA / add-on updatesmanage_update action=list (pending_only=true)
Manage todo list itemsmanage_todo
Manage calendar eventsmanage_calendar
Read HA error/warning logsmanage_system_log action=list
Clear the HA system log buffermanage_system_log action=clear
Get ha-mcp guidance on a topicget_skill action=list / action=read skill=<slug>

Consolidated Tool Action Reference

ToolRead ActionsWrite Actions
manage_automationlist, get, coveragecreate, update, delete, toggle, patch
manage_scriptlist, getcreate, update, delete, execute, patch
manage_scenelist, getcreate, update, delete, activate, patch
manage_helperlist, get_detailscreate, update, delete
manage_dashboardlist, get, findcreate, update, delete, patch
manage_arealist, getcreate, update, delete
manage_entitygetupdate, delete
manage_devicegetupdate, delete
manage_labellist, getcreate, update, delete
manage_floorlist, getcreate, update, delete
manage_zonelist, getcreate, update, delete
manage_personlist, getcreate, update, delete
manage_taglist, getcreate, update, delete
manage_config_entrylist, getdelete (removes entry + its devices/entities)
manage_hacsinfo, list, get, releases, release_notes, criticaldownload, uninstall, add_repository, remove_repository, refresh, toggle_beta
manage_tracelist, get, debug(none — read-only)
manage_blueprintlistimport
manage_updatelist, release_notesinstall, skip
manage_todolist, get_itemsadd_item, update_item, remove_item
manage_calendarlist, get_eventscreate_event, delete_event
manage_system_loglistclear
get_skilllist, read(none — read-only)
query_entitiescurrent, history, statistics, domains, presence, health(none)
query_deviceshealth(none)
analyze_targetall, triggers, conditions, services, entities(none)
get_logbookentries, correlation(none)
helper_action(contextual)toggle, set, increment, decrement, reset, calibrate, start, pause, cancel, finish, change, press, select, set_options, reload, add_entities, remove_entities

manage_helper's update action documents exactly which fields each of the 26 helper types accepts, generated from the helperTypes metadata table (internal/handlers/helpers_consolidated.go) so it can't drift from the code — read the tool's own Description for the per-type field list rather than guessing.

manage_automation / manage_script — create/update Parameters


Content truncated.

When not to use it

  • When the task is not related to Home Assistant management
  • When the user wants to perform actions outside the scope of ha-mcp tools
  • When the user wants to manage Home Assistant without using ha-mcp

Limitations

  • The skill is a guide for choosing tools, not an execution engine
  • It does not perform the Home Assistant actions directly
  • It does not provide guidance on all possible Home Assistant operations

How it compares

This skill acts as a guide to identify the correct ha-mcp tool for a given intent, simplifying the process compared to manually searching through available tools.

Compared to similar skills

ha-mcp-tools side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
ha-mcp-tools (this skill)02moNo flagsBeginner
zendesk154moReviewIntermediate
zapier-workflows118moReviewBeginner
controlling-spotify74moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry