List Helpers
ha_config_list_helpersList Home Assistant helpers by type, returning configurations with IDs, entity IDs, names, icons, and type-specific settings. Supports pagination and all helper types.
Instructions
List Home Assistant helpers of a specific type with their configurations.
Returns one page of helpers; total_count and has_more report the full
set. Each record carries the complete configuration for its helper,
including:
id (immutable storage key), entity_id (current — address the helper by this, where available), name (current display name), original_name (creation-time name), icon
Type-specific settings (min/max for input_number, options for input_select, etc.)
Area and label assignments
For a helper renamed in the UI, id/original_name keep the storage values while entity_id/name reflect the current entity registry (entity_id is the identifier ha_config_set_helper resolves against, so prefer it over id for a renamed helper). entity_id/original_name are present only for storage-collection helpers matched in the entity registry — types with no backing entity (e.g. tag), and every record when the registry read degrades, carry only id/name (a warning flags the degraded case).
SUPPORTED HELPER TYPES:
input_button: Virtual buttons for triggering automations
input_boolean: Toggle switches/checkboxes
input_select: Dropdown selection lists
input_number: Numeric sliders/input boxes
input_text: Text input fields
input_datetime: Date/time pickers
counter: Counters with increment/decrement/reset
timer: Countdown timers with start/pause/cancel
schedule: Weekly schedules with time ranges (on/off per day)
zone: Geographical zones for presence detection
person: Person entities linked to device trackers
tag: NFC/QR tags for automation triggers
EXAMPLES:
List all number helpers: ha_config_list_helpers("input_number")
List all counters: ha_config_list_helpers("counter")
List all zones: ha_config_list_helpers("zone")
List all persons: ha_config_list_helpers("person")
List all tags: ha_config_list_helpers("tag")
List every helper type at once: ha_config_list_helpers("all")
Next page: ha_config_list_helpers("input_boolean", offset=100)
NOTE: Storage types list what HA's {type}/list command returns:
the storage-backed helpers (created via UI/API), not the YAML-defined
ones. person is the exception — HA lists its YAML-configured persons
alongside the storage ones, so both appear here.
Flow-based types (template / group / utility_meter / derivative / etc.) require the ha_mcp_tools custom component (>= 1.1.0) and are served only through it; storage types are listed on all installs. Requesting a flow type without the component returns a COMPONENT_NOT_INSTALLED error.
Pass helper_type="all" to enumerate every helper type in a single call.
Each record carries its own helper_type. This mode is component-only
(there is no single built-in command that lists all types): without the
ha_mcp_tools component it returns a COMPONENT_NOT_INSTALLED error rather
than a partial or empty list.
For detailed helper documentation, use ha_get_skill_guide.
list all helpers input_boolean input_number input_text counter timer input_datetime input_select
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max helpers to return per page (default: 100) | |
| offset | No | Number of helpers to skip for pagination (default: 0) | |
| helper_type | Yes | Helper type to list. Storage types are listed on all installs; flow-based types require the ha_mcp_tools custom component. Pass 'all' to list every helper type in one call (also requires the ha_mcp_tools component). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||