app.onehaus/haus

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.

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

Assign or unassign a task to a household member.

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

Add multiple items to the shopping list at once

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

Buy item (decrements quantity; removes at zero)

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

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.

{"id":"018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"}

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

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

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

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

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.

{"firstName":"Sarah","lastName":"Jones","email":"[email protected]","phone":"\u002B44 7911 123456","address":{"line1":"12 Baker Street","postalCode":"NW1 6XE","countryCode":"GB"},"dateOfBirth":"1990-05-15","notes":"Met at the neighbourhood BBQ.","prepareBirthdayPresent":true}

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

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

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-07-16","mealType":"dinner","recipeId":"8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f","servings":4}

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

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

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.

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

Create a recurring calendar event that automatically generates event instances on a schedule.

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

Create a recurring task that automatically generates task instances on a schedule.

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

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.

{"name":"Netflix","status":"Active","renewalCronExpression":"0 0 1 * *","fee":{"value":1599,"currencyCode":"USD"},"notes":"Family plan, shared with parents","remindMe":true}

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.

{"title":"Take out the recycling","assignedToMemberId":"7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e","dueDate":"2026-08-01","preparationDate":"2026-07-30","notes":"Blue bin only"}

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.

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

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

{"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.

{"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"}

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.

{"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"}

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.

{"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"}

Soft-delete a subscription

{"id":"0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"}

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.

{"id":"018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"}

Soft-delete a vehicle

{"id":"0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"}

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

{"id":"0195e3c1a2b34c5d6e7f8091a2b3c4d5"}

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.

{}

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

{}

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.

{}

Get weather forecast for the household's location

{"forecastDays":3}

List all appliances in the household

{}

List calendar events with optional date-range filters

{"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 global/Discover recipe catalogue (curated recipes available to all households)

{}

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.

{}

List meal plans in the household with an optional date range

{"from":"2026-07-14","to":"2026-07-21"}

List all pets in the household

{}

List all recipes in the household

{}

List all shopping list items in the household

{}

List subscriptions with optional status filter

{"status":"Active"}

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.

{"assignedToMemberId":"7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e","includeCompleted":false,"dueDateOnOrAfter":"2026-07-01","dueDateOnOrBefore":"2026-07-31","limit":20}