Remove Entity
ha_remove_entityPermanently removes orphaned or stale entities from Home Assistant's entity registry. Supports bulk removal of up to 100 entities at once.
Instructions
Remove one or more entities from the Home Assistant entity registry.
Permanently removes the entity registration from Home Assistant. The entity will no longer appear in the UI or be available to automations.
WARNING: This permanently removes the entity registration.
Use only for orphaned or stale entity entries
If the underlying device or integration is still active, the entity may be re-added automatically on the next HA restart or reload
This action cannot be undone without restoring from backup
BULK MODE: Pass a list of entity IDs to remove up to 100 at once — handy for clearing the restored=true orphans an integration leaves behind after its filters change. Removals run sequentially and return: {removed: [...], skipped: [...], errors: [{entity_id, code, message}]} where skipped = ids already absent (not-found is idempotent, not an error). Bulk mode is NOT auto-backed-up (the snapshot is single-entity); single-id removal still is.
EXAMPLES:
Remove orphaned sensor: ha_remove_entity("sensor.old_temperature")
Remove stale helper entry: ha_remove_entity("input_boolean.deleted_helper")
Bulk cleanup: ha_remove_entity(["sensor.orphan_1", "sensor.orphan_2"])
NOTE: For most use cases, consider disabling instead: ha_set_entity(entity_id="sensor.old", enabled=False)
RELATED TOOLS:
ha_search: Find entities to verify the entity_id before removing
ha_get_entity: Check entity details before removal
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entity_id | Yes | Entity ID, or a list of entity IDs, to remove from the entity registry (e.g., 'sensor.old_temperature'). Permanently removes the registration(s). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||