Haus

Create a contact in the household's address book. Only firstName is required; all other details (address, date of birth, notes, a flag to prepare a birthday present) are optional and can be filled in later with 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 all appliances in the household

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.

List calendar events with optional date-range filters

Create a document (passport, insurance, certificate, warranty, license, other)

Update a document. Omitted fields unchanged.

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.

Create a pet. Supports microchip, vet contact, and insurance refs.

Update a pet. Omitted fields unchanged.

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

List all pets in the household

Create a subscription for the household to track a recurring cost, such as a streaming service or membership. Accepts an optional cron-based renewal schedule (must not repeat more frequently than once a day) and a fee amount.

Partially update an existing subscription; only the fields provided are changed, everything else is left as-is. For renewalCronExpression and notes, sending an empty string clears the stored value rather than leaving it unchanged.

Soft-delete a subscription

List subscriptions with optional status filter

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.

Partially update an existing vehicle's details; only the fields provided are changed, everything else is left as-is. For string and due-date fields, omitting the field leaves the stored value unchanged, while sending an empty string clears it.

Soft-delete a vehicle

List all vehicles in the household

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 task title, assignment, dates, or notes.

Soft-deletes a task: it stops appearing in list_tasks but the record is retained rather than permanently removed. Fails if the task 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.

Lists tasks in the household with optional filters (assignee, due-date range, completion status) and cursor-based pagination. Excludes completed tasks by default; results are sorted by due date ascending, with tasks that have no due date listed first.

Get weather forecast for the household's location

Return full details for the household the current session is scoped to: name, address, invite code, notes, join settings, members, subscription status, and resolved feature-flag states. No parameters — the household is resolved server-side from the authenticated session.

List household members with their userId, name, nickname, and role.

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 authenticated user's profile: name, email, AI-consent status, and timezone. Also records this call as user activity (bumps last-seen) as a side effect. No parameters — the user is resolved server-side from the authenticated session.

List all shopping list items in the household

Add an item to the household's shopping list. A brand-new item gets a category auto-assigned from its name. If an unbought item with a matching name already exists, its quantity is merged into that item instead of creating a duplicate, keeping the existing item's category unchanged.

Buy item (decrements quantity; removes at zero)

Return this week's pending House Review recommendations (data gaps like a missing appliance warranty date or vehicle MOT date), re-validated live so items already filled in, actioned, or superseded by an open task are dropped before they're returned. Pro-gated: fails if the household isn't on a Pro

Add Later: defer a House Review recommendation and create a 7-day task

Skip: permanently suppress a House Review recommendation

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 meal plan entry. Any field left out keeps its current value. Provide recipeId to link a recipe (clears any custom name) or name to make it a custom meal (clears the recipe link); recipeId takes precedence when both are given.

Remove a planned meal from the household's meal plan. This is a soft delete: the entry stops appearing in list_meal_plans and its date/meal-type slot becomes free again.

List meal plans in the household with an optional date range

Create a new recipe in the household's recipe collection, with optional ingredients, source URL, instructions and serving size. Link it to a date with create_meal_plan, or browse it later with list_recipes.

Update an existing recipe. Only the fields provided are changed; any field left out keeps its current value. Providing ingredients replaces the entire ingredient list rather than merging with the existing one.

Delete a recipe from the household's collection. This is a soft delete; any meal plan entries still linked to this recipe are automatically converted into custom entries that keep a snapshot of its name, ingredients and instructions, so they aren't left with a dangling recipe link.

List all recipes in the household

List the global/Discover recipe catalogue (curated recipes available to all households)

Add multiple items to the shopping list at once

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 that automatically 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 that automatically 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.