Get Entity
ha_get_entityRetrieve Home Assistant entity registry details, including area, labels, device info, and aliases; resolve a stable unique_id to its entity_id(s) to identify or inspect entities.
Instructions
Get entity registry information for one or more entities.
Returns detailed entity registry metadata: area, custom name/icon, original name, disabled_by/hidden_by (with enabled/hidden shorthands), aliases (a null entry = the entity's own name), labels, categories, device_class override, per-domain options, platform, device_id, config_entry_id and unique_id.
RESOLVER MODE:
Pass unique_id (instead of entity_id) to resolve a stable integration
unique_id to its entity_id(s). Since the registry's unique key is
(domain, platform, unique_id), the same unique_id can match multiple
platforms — all matches are returned in entity_entries with a matches
count. Narrow with domain/platform. Resolver reads as_partial_dict, so
aliases and the device_class override come back as defaults ([]/null).
When config_entry_id is non-null — e.g. for UI-created template / group /
utility_meter / derivative helpers — pass it to
ha_get_integration(entry_id=..., include_options=True) to read the
helper's current config (template body, group members, etc.) without
scanning a domain list. Voice-assistant exposure is stored under options
but is set via ha_set_entity(expose_to=...).
Resolved-name enrichment (present only when the ha_mcp_tools component
advertises it; otherwise these keys are absent): area (assigned area
NAME, device-inherited when the entity has none), floor, and
label_names. This tool's base labels carries the label ids;
ha_search result_fields and ha_get_entity_exposure instead emit the
resolved names under labels.
RELATED TOOLS: ha_set_entity() to modify these properties; ha_get_state() for current state/attributes; ha_search() to find entities.
EXAMPLES:
Single entity: ha_get_entity("sensor.temperature")
Multiple entities: ha_get_entity(["light.living_room", "switch.porch"])
Resolve a unique_id: ha_get_entity(unique_id="00:11:22:33", domain="sensor")
get entity state attributes details single specific entity_id
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | No | Resolver filter (unique_id mode only): restrict matches to this entity domain, e.g. 'sensor'. | |
| platform | No | Resolver filter (unique_id mode only): restrict matches to this integration platform, e.g. 'hue'. | |
| entity_id | No | Entity ID or list of entity IDs to retrieve (e.g., 'sensor.temperature' or ['light.living_room', 'switch.porch']). | |
| unique_id | No | Stable integration unique_id (entity_id is mutable, unique_id is not). Mutually exclusive with entity_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||