Returns the current date and time from the Home Assistant server (Home). Call this before time-based queries that use relative or named periods such as "last month", "this winter", "yesterday", or "recently". Do not rely on your training data to infer the current date — it will often be wrong. Skip only if an absolute ISO date range has already been stated in this conversation.

Lists the areas (rooms and locations) defined in Home. Use when the user wants to explore areas or when you need the exact area name for ha_history_list_devices. Narrow by name with search. Returns area names to reuse with area="" in ha_history_list_devices, which also surfaces ready entity_ids.

Lists devices in Home, filtered by area or search. Use area for room-based discovery and search for device or appliance lookup. Returns matched devices together with analytics-ready entity_ids on each device. Use the returned entity_ids directly with the analytics tools. Call ha_history_list_device_entities only when you need deeper per-device inspection.

Lists entities (sensors and controls) on a specific device in Home. Use when ha_history_list_devices did not already surface the needed entity_ids or when you need a deeper per-device inspection. Returns entity_ids with their metric kind and analytics capability. Use measurement sensors with ha_history_get_sensor_stats and cumulative counters with ha_history_get_consumption.

Primary discovery tool for the exact entity_ids that the ha_history_* analytics tools require. Filter by area, device, device_class, and search. Results are grouped by area and device and include entity_id, name, unit, and type. For one entity's live state, use ha_history_get_state after discovery. Not needed before device-control (Hass*) tools — those take plain names and areas, never entity_ids.

Returns the current state of one Home entity by exact entity_id. Works for all entity domains, including entities not exposed to the voice assistant. Returns the state value, unit, last_changed/last_updated timestamps, and key attributes. If a GetLiveContext tool is available, prefer it for current values of exposed entities; use this tool for entities it cannot see, for staleness checks via timestamps, or when the entity_id is already resolved.

Computes statistics for one or more instantaneous-value sensors such as temperature, humidity, CO₂, pressure, illuminance, or power in W. Always pass entity_ids as an array. Prefer one multi-entity call over repeated single-entity calls when units match. Use aggregations for several whole-period stats in one call. Use interval for time series and group_by for repeating patterns. Do not use for cumulative consumption in kWh; use ha_history_get_consumption. Do not use for event counting; use ha_history_detect_sessions.

Calculates how much energy, water, gas, or other resource was consumed or produced in Home over a time period. Use for totals, interval breakdowns, and period-over-period comparisons of cumulative meters. Always returns consumption (the change over the period), never raw meter readings. Do NOT use for instantaneous sensors (temperature, power in Watts) → use ha_history_get_sensor_stats.

Detects activity sessions from a numeric sensor using a power/value threshold. Use for threshold-based activity questions such as charging sessions, appliance runs, or heating cycles. Uses long-term hourly statistics → full date range, no retention limit, ±1h precision. For binary sensors or person/zone state history, use ha_history_get_state_history instead. Returns event count, total duration, a compact session list, or a daily summary with group_by="day".

Gets the state-change history for any discrete-state entity in Home. Use for binary sensors (motion, door, window, presence), person/device_tracker (zone and location history), and any entity with named states.

Two modes: session mode when state_value is set, timeline mode when it is omitted. Source: HA recorder state history — limited to ~10 days by default. Returns a timeline of transitions, or session counts and durations when state_value is set.