ha-direct MCP Tools Reference
Use these tools only when ha-direct specific features are needed (BPS, backup, python_transform).
Automations
| Tool |
Purpose |
ha_config_get_automation |
Read automation config |
ha_config_set_automation |
Create/update automation |
ha_config_remove_automation |
Delete automation |
ha_get_automation_traces |
Debug automation execution |
Scripts
| Tool |
Purpose |
ha_config_set_script |
Create/update script |
Scenes
| Tool |
Purpose |
ha_config_get_scene |
Read scene config |
ha_config_set_scene |
Create/update scene |
ha_config_remove_scene |
Delete scene |
Dashboards
| Tool |
Purpose |
ha_config_get_dashboard |
List/get/search dashboards |
ha_config_set_dashboard |
Create/update dashboard |
ha_config_delete_dashboard |
Delete dashboard |
Entities
| Tool |
Purpose |
ha_get_entity |
Get entity registry info |
ha_set_entity |
Update entity properties |
ha_remove_entity |
Remove entity |
Labels/Categories
| Tool |
Purpose |
ha_config_get_label |
List/get labels |
ha_config_set_label |
Create/update label |
ha_config_remove_label |
Delete label |
ha_config_get_category |
List/get categories |
ha_config_set_category |
Create/update category |
ha_config_remove_category |
Delete category |
System
| Tool |
Purpose |
ha_reload_core |
Reload config without restart |
ha_manage_updates |
Manage system updates |
ha_get_overview |
System overview |
ha_get_skill_guide |
Best practices |
ha_report_issue |
File bug reports |
Control
| Tool |
Purpose |
ha_call_service |
Call any HA service |
ha_call_event |
Fire custom event |
Search
| Tool |
Purpose |
ha_search |
Search entities/configs |
Notes
- Write tools require
BestPracticeKey (read from SKILL.md first)
- Key rotates hourly, re-read for fresh key
python_transform requires config_hash from GET call
