Home Assistant

list_entities

List entities in the user's Home Assistant. Returns entity_id, domain, friendly_name, and state for each. Filter by domain (e.g. 'light', 'switch', 'sensor', 'media_player', 'climate', 'todo') to keep the response compact — a typical HA install has hundreds of entities.

get_state

Fetch the full current state and attributes for a single Home Assistant entity. Use after list_entities to drill into a specific device — returns brightness, temperature, supported features, and any other attributes the entity exposes.

get_history

Fetch state-change history for a Home Assistant entity over a time range. Use this to answer questions like 'how many times did the leak sensor trigger this week' or 'when was the garage door last opened'. Returns a chronological list of state changes with timestamps. Use list_entities first to find the entity_id.

get_logbook

Fetch the Home Assistant logbook: a human-readable event log showing what happened and when. More readable than get_history but less structured. Can filter to a single entity or return all events. Good for questions like 'what happened in the house today' or 'show me recent activity for the front door'.

call_service

Call a Home Assistant service. Use for any state-changing action: turn_on, turn_off, toggle, set_temperature, play_media, add_item, etc. Examples: domain='light' service='turn_on' service_data={'entity_id': 'light.kitchen', 'brightness_pct': 30}; domain='climate' service='set_temperature' service_data={'entity_id': 'climate.living_room', 'temperature': 68}. Confirm destructive or noticeable actions with the user first. Call get_agent_instructions before the first write in a conversation.

get_todo_items

Fetch all items from a Home Assistant todo list. Returns each item's uid, summary, status (needs_action or completed), description, and due date. Use list_entities with domain='todo' first to discover available lists.

add_todo_item

Add a new item to a Home Assistant todo list. Optionally set a due date or due datetime and a description.

update_todo_item

Update an existing item on a Home Assistant todo list. Can rename it, change its status (needs_action or completed), update the due date, or change the description. Use get_todo_items first to find the item name.

remove_todo_item

Remove an item from a Home Assistant todo list. Use get_todo_items first to find the exact item name.

save_profile

Save or update profile notes scoped to the Home Assistant integration. Use for room layout, entity nicknames, scenes the user cares about, and entities to leave alone. Call get_agent_instructions first.