list_entities
Retrieve and filter Home Assistant entities by domain, search query, or specific fields. Returns lean or detailed entity data based on request parameters, aiding smart home management and automation tasks via Hass-MCP.
Instructions
Get a list of Home Assistant entities with optional filtering
Args: domain: Optional domain to filter by (e.g., 'light', 'switch', 'sensor') search_query: Optional search term to filter entities by name, id, or attributes (Note: Does not support wildcards. To get all entities, leave this empty) limit: Maximum number of entities to return (default: 100) fields: Optional list of specific fields to include in each entity detailed: If True, returns all entity fields without filtering
Returns: A list of entity dictionaries with lean formatting by default
Examples: domain="light" - get all lights search_query="kitchen", limit=20 - search entities domain="sensor", detailed=True - full sensor details
Best Practices: - Use lean format (default) for most operations - Prefer domain filtering over no filtering - For domain overviews, use domain_summary_tool instead of list_entities - Only request detailed=True when necessary for full attribute inspection - To get all entity types/domains, use list_entities without a domain filter, then extract domains from entity_ids
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detailed | No | ||
| domain | No | ||
| fields | No | ||
| limit | No | ||
| search_query | No |