app.onehaus/haus

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.

{"name":"Milk","quantity":2}

Add a task pack from list_task_packs to the household: creates its tasks, repeating tasks and events, dated from the anchor date. The pack's titles are English: when the user is not writing in English, pass their titles (and notes) translated in overrides. Returns how many of each were created.

{"anchorDate":"2026-11-28","packId":"moving-house","timezone":"Europe/London"}

{"entityId":"0190c2d3e4f5a6b7c8d9e0f1a2b3c4d5","itemIds":["check-tyre-pressure","service-car"],"packId":"car-maintenance"}

{"itemIds":["wipe-counters"],"overrides":[{"itemId":"wipe-counters","title":"Arbeitsflächen abwischen"}],"packId":"weekly-household-reset"}

Assign or unassign a task to a household member.

{"assignedToMemberId":"7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e","id":"018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"}

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.

{"items":[{"name":"Milk","quantity":2},{"name":"Eggs","quantity":1}]}

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

{"id":"0189c8d4f2b1712a9e4d6c9a1b2e3f4a","quantityToBuy":1}

Marks a task as completed. Fails with a conflict if the task is already completed.

{"id":"018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"}

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

{"brand":"Samsung","model":"RF28R7351SG","name":"Kitchen Refrigerator","purchaseDate":"2023-11-04","serialNumber":"S/N-4471829","warrantyExpiryDate":"2025-11-04"}

Creates a single, one-off calendar event on the household calendar. Timed events need startDateTime; all-day events need startDate (plus endDate for several days). Set reminders with reminderOffsetMinutes. For a repeating schedule use create_recurring_calendar_event instead.

{"description":"Annual checkup with Dr. Smith","endDateTime":"2026-08-03T15:30:00Z","isAllDay":false,"location":{"$type":"Address","countryCode":"GB","line1":"221B Baker Street","postalCode":"NW1 6XE"},"notes":"Bring insurance card","reminderOffsetMinutes":[60,1440],"startDateTime":"2026-08-03T14:30:00Z","timezone":"Europe/London","title":"Dentist appointment"}

{"endDate":"2026-10-30","isAllDay":true,"startDate":"2026-10-26","title":"Half term"}

Subscribe the household to an external calendar feed (an .ics link, e.g. a school, club or bin collection calendar) so its events appear in the household calendar and stay in sync. Only subscribe to a feed link the user typed themselves in this conversation. Only the house owner can do this; a house can have up to 5 feeds. The feed is checked before it is saved; its events appear after the feed's next refresh, which can take a few hours.

{"feedUrl":"webcal://calendar.oakwoodprimary.example/term-dates.ics","name":"School calendar"}

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.

{"address":{"countryCode":"GB","line1":"12 Baker Street","postalCode":"NW1 6XE"},"dateOfBirth":"1990-05-15","email":"sarah.jones@example.com","firstName":"Sarah","lastName":"Jones","notes":"Met at the neighbourhood BBQ.","phone":"+44 7911 123456","prepareBirthdayPresent":true}

Store a document (passport, insurance, certificate, warranty, license, other) with its reference number, issuing authority, fee and notes. Optionally file it against a pet, vehicle or appliance with linkedEntityType and linkedEntityId. Returns the new id, which an appliance, vehicle or pet can link to.

{"documentNumber":"512345678","documentType":"Passport","fee":{"currencyCode":"GBP","value":8250},"issuingAuthority":"HM Passport Office","notes":"Renew before the next family trip.","title":"UK Passport"}

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.

{"date":"2026-10-28","mealType":"dinner","recipeId":"8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f","servings":4}

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.

{"dateOfBirth":"2021-06-15","microchipNumber":"985141000123456","name":"Bella","notes":"Allergic to chicken; on prescription food."}

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

{"ingredients":[{"name":"chicken breast","quantity":2},{"name":"tomato","quantity":4}],"instructions":"Marinate the chicken, then simmer in the spiced tomato sauce for 20 minutes.","name":"Chicken Tikka Masala","servings":4,"url":"https://example.com/recipes/chicken-tikka-masala"}

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

{"cronExpression":"1 Week","description":"Sync on sprint progress","duration":"PT30M","endDate":"2026-12-31","isAllDay":false,"maxOccurrences":20,"notes":"Bring your laptop","reminderOffsetMinutes":[60],"startDate":"2026-08-03","startTime":"09:00:00","timezone":"Europe/London","title":"Weekly team standup"}

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

{"assigneeRotation":["7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e","a1b2c3d4e5f60718293a4b5c6d7e8f90"],"cronExpression":"2 Week","endDate":"2026-12-31","maxOccurrences":26,"notes":"Blue bin only","reminderOffsetMinutes":[1440],"startDate":"2026-08-01","title":"Take out the recycling"}

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.

{"name":"Party"}

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.

{"fee":{"currencyCode":"USD","value":1599},"name":"Netflix","notes":"Family plan, shared with parents","paymentDate":"2026-10-03","remindMe":true,"renewalCronExpression":"0 0 1 * *","startDate":"2026-10-01","status":"Active"}

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.

{"assignedToMemberId":"7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e","dueDate":"2026-08-01","notes":"Blue bin only","reminderOffsetMinutes":[1440,10080],"title":"Take out the recycling"}

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.

{"colour":"Blue","make":"Toyota","model":"Corolla","motDueDate":"2026-11-15","notes":"Winter tyres fitted","registration":"AB21 CDE","serviceDueDate":"2027-01-20","taxDueDate":"2026-09-01","vin":"1HGCM82633A004352","year":2021}

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

{"recommendationId":"0195e3c1a2b34c5d6e7f8091a2b3c4d5"}

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

{"id":"01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"}

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.

{"id":"0198f3a1b2c34d5e6f7089ab1c2d3e4f"}

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.

{"id":"01928e4a7d3f7b9ac1e3f6d8b2a4c710"}

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.

{"id":"01928e4a7d3f7b9ac1e3f6d8b2a4c710"}

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

{"id":"8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"}

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

{"id":"01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"}

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.

{"id":"8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"}

Delete a recurring calendar event and all its future instances.

{"id":"0198f3a1b2c34d5e6f7089ab1c2d3e4f"}

Delete a recurring task and all its uncompleted future instances.

{"id":"5c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f"}

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.

{"id":"0190a1b2c3d47e8f9a0b1c2d3e4f5a6b"}

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

{"id":"0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"}

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

{"id":"018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"}

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

{"id":"0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"}

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

{"id":"0195e3c1a2b34c5d6e7f8091a2b3c4d5"}

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.

{"forecastDays":3}

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 timezone when it has one.

{"startDateFrom":"2026-07-01T00:00:00Z","startDateTo":"2026-07-31T23:59:59Z"}

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.

{}

{"documentType":"Passport"}

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.

{}