app.onehaus/haus

Add a contact to the address book. Only firstName is required; address, date of birth, notes and the birthday-present flag can follow via update_contact.

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).

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.

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

Create an appliance record for the household, tracking purchase date, warranty expiry, and optional references to previously created warranty/insurance documents.

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.

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

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

Creates a single, one-off calendar event on the household calendar. For a repeating schedule use create_recurring_calendar_event instead.

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.

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 cale…

List one-off calendar events with their title, times, location and notes. Bound them with startDateFrom and startDateTo, or omit both for everything.

Store a document (passport, insurance, certificate, warranty, license, other) with its reference number, issuing authority, fee and notes. Returns the new id, which an appliance, vehicle or pet can li…

Update a stored document's type, title, reference number, issuing authority, fee or notes, returning the updated document. Only the fields you send change. renewalCronExpression is the one exception: …

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.

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

Add a pet, optionally with its microchip number and date of birth, and links to an existing contact as vet and document as insurance. Returns the new pet's id.

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.

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

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

Track a recurring cost such as a streaming service or membership, with an optional fee and cron renewal schedule (no more often than daily).

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

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

List tracked subscriptions with their fee, renewal schedule and status. Pass status to filter to one.

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.

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

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

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.

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

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

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

Marks a task as completed and records the completion for the household's momentum stats. Fails with a conflict if the task is already completed.

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

Assign or unassign a task to a household member.

List tasks, filterable by assignee, due-date range and completion, with cursor pagination. Excludes completed tasks by default and sorts by due date ascending, undated first.

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

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

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.

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

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 to…

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

Add one item to the shopping list. A new item gets a category from its name; if an unbought item of the same name exists, its quantity is increased instead of duplicating it.

Mark units of a shopping list item as bought, reducing its quantity by quantityToBuy and clearing it off the list once nothing is left.

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 …

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

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.

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

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

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.

Plan a meal for a specific date and meal type. Provide recipeId to link an existing recipe (from list_recipes) OR name for a custom meal; when recipeId is given any name is ignored and stored as null.

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.

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

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

Save a recipe with optional ingredients, source URL, instructions and servings. Link it to a date with create_meal_plan.

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

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.

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

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

Add up to 25 shopping list items at once, for a whole shop. Names are deduplicated within the batch and merged into any matching unbought item already listed.

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.

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.

Create a recurring calendar event. It generates event instances on a schedule.

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

Delete a recurring calendar event and all its future instances.

Create a recurring task. It generates task instances on a schedule.

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

Delete a recurring task and all its uncompleted future instances.

Generic list/detail widget for Haus entities.