Haus

Create a recurring task. It generates task instances on a schedule, each with the reminders set in reminderOffsetMinutes.

Create a new named shopping list for the household (e.g. 'DIY' or 'Party') alongside the default list. A house can have up to 20 lists. Returns the list id to pass as shoppingListId when adding items.

Track a bill such as a streaming service or membership, with an optional fee and cron renewal schedule (no more often than daily). A bill with no renewal schedule is a one-off. Set paymentDate only when the money leaves the account on a different day from the renewal.

Creates a new household task. Only title is required; the task starts unassigned and uncompleted. Set reminders with reminderOffsetMinutes. Use assign_task, update_task, or complete_task to change it afterward.

Create a vehicle record for the household to track its details, registration and VIN, insurance document, and upcoming MOT/tax/service due dates. All fields are optional.

Defer a House Review recommendation and raise a task due in seven days, for when the user wants to handle the gap later.

Soft-delete an appliance; it is hidden from list_appliances but not permanently erased.

Soft-deletes a single calendar event by id. Events imported from a calendar subscription cannot be deleted here; unsubscribe from the source calendar instead. Events shared from a member's device calendar can only be removed by that member or the house owner.

Soft-delete a contact by id; it is marked deleted and no longer appears in list_contacts, but the underlying record is retained rather than permanently erased.

Soft-delete a document by id and cascade soft-delete its attachments; none of them appear in listings afterward, but the records are retained rather than permanently erased.

Soft-delete a planned meal. The entry leaves list_meal_plans and frees its date and meal slot again.

Soft-delete a pet; it is hidden from list_pets but not permanently erased.

Soft-delete a recipe. Meal plan entries linked to it become custom entries holding a snapshot of its name, ingredients and instructions, so none are left with a dangling link.

Delete a recurring calendar event and all its future instances.

Delete a recurring task and all its uncompleted future instances.

Delete one of the household's named shopping lists. Its items move to the default list rather than being deleted. The default list itself cannot be deleted.

Soft-delete a subscription so it leaves list_subscriptions; the record is retained. Use it when the user cancels a service.

Soft-delete a task. It leaves list_tasks but the record is retained. Fails if it was already deleted.

Soft-delete a vehicle so it leaves list_vehicles; the record is retained. Use it when the household sells a car.

Forget (soft-delete) a memory by id. Use when a memory is superseded or no longer relevant.

Return the current household in full: name, address, invite code, notes, join settings, members, subscription status and resolved feature flags.

Return this week's pending House Review recommendations: data gaps like a missing appliance warranty or vehicle MOT date. Re-validated live, so items already filled in, actioned or covered by an open task are dropped. Pro-gated.

Return the signed-in user's profile: name, email, AI-consent status and timezone. Also bumps their last-seen activity as a side effect.

Return a one-to-five day forecast for the household's location, for planning outdoor tasks or events.

List the household's appliances with brand, model, serial number, purchase date and warranty expiry. Answers whether something is still under warranty.

List one-off calendar events with their title, times, location and notes. Bound them with startDateFrom and startDateTo, or omit both for everything. An all-day event's end depends on its sourceEntityType. With no source, endDateTime is its LAST day (inclusive), or null for a single day. For 'deviceCalendar' and 'calendarSubscription' it is the day AFTER the last day (exclusive). For 'RecurringCalendarEvent' the event covers endDateTime minus startDateTime in whole days, rounded up (a single day when null). Read a 00:00Z value as its UTC date; read any other all-day value in the event's timezo…

List all contacts in the household. Takes no parameters; soft-deleted contacts are excluded.

List documents in the household, optionally filtered to a single document type. Soft-deleted documents are excluded.

List the curated Discover recipe catalogue shared by all households. Pass an id from here to create_meal_plan with recipeSource='global'.

List the household's members with id, userId, first and last name, nickname and role. Use a member's id as assignedToMemberId in create_task and assign_task.

List the households the current user belongs to (e.g. to tell the user which home you are acting on). The active house is determined server-side from the authenticated session.

List planned meals with their date, meal slot, linked recipe or custom name, servings and notes. Narrow with from and to.

List the household's pets with microchip number, date of birth, notes and their linked vet contact and insurance document.

List the household's own saved recipes with ingredients, instructions, source URL and servings. For the shared catalogue use list_global_recipes.

List the household's repeating calendar events (the series, not their generated instances) with their id, title, interval ('N Unit'), local start time, duration, dates, timezone and reminders. Use it to find the id for update_recurring_calendar_event or delete_recurring_calendar_event.

List the household's repeating tasks (the series, not their generated instances) with their id, title, interval ('N Unit'), dates, rotation and reminders. Use it to find the id for update_recurring_task or delete_recurring_task, e.g. to stop or change a weekly chore.

List outstanding (unbought) shopping list items with their name, quantity, category and shoppingListId. Pass shoppingListId to limit it to one named list.

List the household's named shopping lists with their id, name, whether they are the default list, and how many live items each holds. Use this to resolve a shoppingListId for the shopping list item tools.

List tracked subscriptions with their fee, renewal schedule, payment date and status. A subscription with no renewal schedule is a one-off. startDate is the renewal date: the first renewal of a recurring bill, or when a one-off is due; paymentDate, when set, is the first day money leaves the account and repeats on the renewal cadence. Pass status to filter to one.

List the ready-made task packs the household can add (e.g. moving house, a new baby, car maintenance): each pack's id, title, description and items (id, kind, title, whether it is selected by default, days before the anchor date, repeat interval). Packs for a vehicle, appliance or pet list the owned items they can be linked to (entities) with a suggested anchor date. Use it before apply_task_pack.

List tasks, filterable by assignee, due-date range and completion, with cursor pagination. Excludes completed tasks by default and sorts open urgent tasks first (within the returned page), then due date ascending (undated first).

List the household's vehicles with make, model, year, registration, VIN and MOT, tax and service due dates. Answers questions like when the MOT is due.

Recall long-term memories stored about the current household. Call this at the start of advisory or open-ended turns. Filter by type when only one author's notes are relevant.

Remove an item from the household's shopping list without marking it as bought. This soft-deletes the item so it no longer appears in list_shopping_list_items.

Permanently suppress a House Review recommendation so get_house_review stops returning it. Use it when the suggestion does not apply.

Store a long-term memory about the household. Use sparingly for durable preferences, routines, constraints, or insights worth recalling in a future conversation. Recall first to avoid duplicates.

Reopens a completed task, clearing its completion timestamp and completed-by user. Fails with a conflict if the task is not currently completed.

Update an appliance's details; omitted fields keep their current value. Rejects the update if the resulting warranty expiry date would fall before the purchase date.

Updates fields on an existing single calendar event; only the fields supplied are changed, all others keep their current value. Imported (subscription-sourced) events cannot be edited.

Update a contact by id. Only the fields supplied are changed; omitted fields keep their current value (dateOfBirth is the exception: an empty string explicitly clears it).

Update a stored document's type, title, reference number, issuing authority, fee, notes or linked pet, vehicle or appliance, returning the updated document. Only the fields you send change. renewalCronExpression is the one exception: it is accepted but not yet stored or acted on, so sending it changes nothing.

Update a planned meal. Only the fields you send change. recipeId links a recipe and clears any custom name; name makes it custom and clears the link; recipeId wins if both are sent.

Update an existing memory's name, description, or content. Type is immutable; to reclassify, forget and store again.

Update a pet's name, microchip number, date of birth, notes, or its linked vet contact and insurance document. Only the fields you send change.

Update a recipe. Only the fields you send change, except ingredients, which replaces the whole existing list rather than merging.

Update a recurring calendar event. Changes to title/description/notes/reminders patch existing instances. Changes to frequency/dates/time regenerate future instances.

Update a recurring task. Title, notes, urgency or reminder changes patch existing instances; frequency/date changes regenerate future instances.

Rename one of the household's shopping lists, including the default list. The items on it are unchanged.

Update a shopping list item's name, quantity, and/or category. Only the fields provided are changed; any field left out keeps its current value.

Update a subscription. Only the fields you send change; for renewalCronExpression, startDate, paymentDate and notes an empty string clears the stored value.

Update a task's title, assignee, due date, reminders, notes or urgency. Only the fields you send change.

Update a vehicle. Only the fields you send change; for text and due-date fields an empty string clears the stored value.