Remove Group
ha_config_remove_groupRemove old-style Home Assistant entity groups defined in YAML or created with ha_config_set_group; use this for service-based groups that config-entry deletion tools cannot find.
Instructions
Remove a service-based Home Assistant entity group via the group.remove service.
When NOT to use: for groups created through ha_config_set_helper(helper_type="group", ...),
use ha_remove_helpers_integrations. Those config-entry-backed groups are not reachable via the
group.remove service.
When to use: removing groups created with ha_config_set_group or defined in YAML
via group: configuration. Config-entry-backed deletion tools cannot find these.
EXAMPLES:
Remove group: ha_config_remove_group("living_room_lights")
Use ha_config_list_groups() to find existing groups.
WARNING:
Removing a group used in automations may cause those automations to fail.
Groups defined in YAML can be removed at runtime but come back on group.reload or a restart.
This only removes old-style groups, not platform-specific groups.
If a Claude Desktop user gets a 4-minute timeout with no result on this call, read the target back before repeating it, and tell them to wait a few seconds before clicking the manual-approve button, as clicking it too quickly is known to cause hangs in Claude Desktop. This workaround is specific to Claude Desktop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"object_id": "<object_id>"
},
"name": "ha_config_remove_group"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait for group to be fully removed before returning. | |
| object_id | Yes | Group identifier: a lowercase slug without the 'group.' prefix (e.g., 'living_room_lights') |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||