app.onehaus/haus

Official68 tools

by onehaus

OneHaus household tools: tasks, calendar, contacts, pets, vehicles, documents and more.

MCP Server: app.onehaus/haus

The MCP server app.onehaus/haus exposes “OneHaus household tools,” covering tasks, calendar, contacts, pets, vehicles, documents, and more. Its catalog entry reports a total of 68 available tools for interacting with household-related information and workflows.

🛠️ Key Features

OneHaus household tools
Tasks
Calendar
Contacts
Pets
Vehicles
Documents
68 tools available

🚀 Use Cases

Manage household tasks
Work with household calendars
Store or retrieve contact information
Handle pets and related records
Track vehicles
Organize household documents

⚡ Developer Benefits

Fixed tool surface: 68 tools
Structured access to multiple household domains in one server

⚠️ Limitations

No additional details provided on authentication, schemas, or specific tool capabilities beyond the listed domains

Captured live from the server via tools/list.

create_contact

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.

Parameters9

firstName	string	required	The contact's first name. The only required field.
lastName	string	optional	The contact's last (family) name.
displayName	string	optional	An alternate name to show for the contact instead of first/last, e.g. a nickname, company name, or role.
email	string	optional	The contact's email address.
phone	string	optional	The contact's phone number, in any format.
address	object	optional	The contact's postal address.
dateOfBirth	string	optional	YYYY-MM-DD format
notes	string	optional	Free-text notes about the contact.
prepareBirthdayPresent	boolean	optional	Whether to prepare a birthday present for this contact

Raw schema

{
  "type": "object",
  "properties": {
    "firstName": {
      "type": "string",
      "description": "The contact's first name. The only required field.",
      "examples": [
        "Sarah"
      ]
    },
    "lastName": {
      "type": "string",
      "description": "The contact's last (family) name."
    },
    "displayName": {
      "type": "string",
      "description": "An alternate name to show for the contact instead of first/last, e.g. a nickname, company name, or role."
    },
    "email": {
      "type": "string",
      "description": "The contact's email address.",
      "examples": [
        "sarah.jones@example.com"
      ]
    },
    "phone": {
      "type": "string",
      "description": "The contact's phone number, in any format.",
      "examples": [
        "+44 7911 123456"
      ]
    },
    "address": {
      "type": "object",
      "description": "The contact's postal address.",
      "properties": {
        "line1": {
          "type": "string",
          "description": "First line of the address, typically house number and street."
        },
        "line2": {
          "type": "string",
          "description": "Second line of the address, e.g. apartment, suite, or unit."
        },
        "line3": {
          "type": "string",
          "description": "Third line of the address, e.g. town or city."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code (e.g., GB, US)",
          "examples": [
            "GB"
          ]
        }
      }
    },
    "dateOfBirth": {
      "type": "string",
      "description": "YYYY-MM-DD format",
      "examples": [
        "1990-05-15"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the contact."
    },
    "prepareBirthdayPresent": {
      "type": "boolean",
      "description": "Whether to prepare a birthday present for this contact"
    }
  },
  "required": [
    "firstName"
  ],
  "examples": [
    {
      "firstName": "Sarah",
      "lastName": "Jones",
      "email": "sarah.jones@example.com",
      "phone": "+44 7911 123456",
      "address": {
        "line1": "12 Baker Street",
        "postalCode": "NW1 6XE",
        "countryCode": "GB"
      },
      "dateOfBirth": "1990-05-15",
      "notes": "Met at the neighbourhood BBQ.",
      "prepareBirthdayPresent": true
    }
  ]
}

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

Parameters10

id	string	required	The id of the contact to update, as returned by create_contact or list_contacts.
firstName	string	optional	The contact's first name. Omit to leave unchanged.
lastName	string	optional	The contact's last (family) name. Omit to leave unchanged.
displayName	string	optional	An alternate name to show for the contact instead of first/last, e.g. a nickname, company name, or role. Omit to leave unchanged.
email	string	optional	The contact's email address. Omit to leave unchanged.
phone	string	optional	The contact's phone number, in any format. Omit to leave unchanged.
address	object	optional	The contact's postal address. Omit to leave unchanged; when supplied, replaces the whole address.
dateOfBirth	string	optional	YYYY-MM-DD format. Omit or pass null to leave unchanged; pass an empty string to clear it.
notes	string	optional	Free-text notes about the contact. Omit to leave unchanged.
prepareBirthdayPresent	boolean	optional	Whether to prepare a birthday present for this contact. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the contact to update, as returned by create_contact or list_contacts.",
      "examples": [
        "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
      ]
    },
    "firstName": {
      "type": "string",
      "description": "The contact's first name. Omit to leave unchanged."
    },
    "lastName": {
      "type": "string",
      "description": "The contact's last (family) name. Omit to leave unchanged."
    },
    "displayName": {
      "type": "string",
      "description": "An alternate name to show for the contact instead of first/last, e.g. a nickname, company name, or role. Omit to leave unchanged."
    },
    "email": {
      "type": "string",
      "description": "The contact's email address. Omit to leave unchanged.",
      "examples": [
        "sarah.jones@example.com"
      ]
    },
    "phone": {
      "type": "string",
      "description": "The contact's phone number, in any format. Omit to leave unchanged.",
      "examples": [
        "+44 7911 123456"
      ]
    },
    "address": {
      "type": "object",
      "description": "The contact's postal address. Omit to leave unchanged; when supplied, replaces the whole address.",
      "properties": {
        "line1": {
          "type": "string",
          "description": "First line of the address, typically house number and street."
        },
        "line2": {
          "type": "string",
          "description": "Second line of the address, e.g. apartment, suite, or unit."
        },
        "line3": {
          "type": "string",
          "description": "Third line of the address, e.g. town or city."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code (e.g., GB, US)",
          "examples": [
            "GB"
          ]
        }
      }
    },
    "dateOfBirth": {
      "type": "string",
      "description": "YYYY-MM-DD format. Omit or pass null to leave unchanged; pass an empty string to clear it.",
      "examples": [
        "1990-05-15"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the contact. Omit to leave unchanged."
    },
    "prepareBirthdayPresent": {
      "type": "boolean",
      "description": "Whether to prepare a birthday present for this contact. Omit to leave unchanged."
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01928e4a7d3f7b9ac1e3f6d8b2a4c710",
      "phone": "+44 7911 123456",
      "notes": "Prefers texts over calls."
    }
  ]
}

delete_contact

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.

Parameters1

string

required

The id of the contact to delete, as returned by create_contact or list_contacts.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the contact to delete, as returned by create_contact or list_contacts.",
      "examples": [
        "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
    }
  ]
}

list_contacts

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "examples": [
    {}
  ]
}

create_appliance

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

Parameters9

name	string	required	Name of the appliance, e.g. what it is or where it's located.
brand	string	optional	Manufacturer or brand name.
model	string	optional	Model name or number, as printed on the appliance or its manual.
serialNumber	string	optional	Manufacturer serial number, used when contacting support or filing a warranty claim.
purchaseDate	string	optional	Date the appliance was purchased, in YYYY-MM-DD format.
warrantyExpiryDate	string	optional	Date the manufacturer warranty expires, in YYYY-MM-DD format. Must not be before purchaseDate.
warrantyDocumentId	string	optional	ID of a previously created document containing the warranty paperwork.
insuranceDocumentId	string	optional	ID of a previously created document containing the insurance policy.
notes	string	optional	Freeform notes about the appliance.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the appliance, e.g. what it is or where it's located.",
      "examples": [
        "Kitchen Refrigerator"
      ]
    },
    "brand": {
      "type": "string",
      "description": "Manufacturer or brand name.",
      "examples": [
        "Samsung"
      ]
    },
    "model": {
      "type": "string",
      "description": "Model name or number, as printed on the appliance or its manual.",
      "examples": [
        "RF28R7351SG"
      ]
    },
    "serialNumber": {
      "type": "string",
      "description": "Manufacturer serial number, used when contacting support or filing a warranty claim.",
      "examples": [
        "S/N-4471829"
      ]
    },
    "purchaseDate": {
      "type": "string",
      "description": "Date the appliance was purchased, in YYYY-MM-DD format.",
      "examples": [
        "2023-11-04"
      ]
    },
    "warrantyExpiryDate": {
      "type": "string",
      "description": "Date the manufacturer warranty expires, in YYYY-MM-DD format. Must not be before purchaseDate.",
      "examples": [
        "2025-11-04"
      ]
    },
    "warrantyDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the warranty paperwork.",
      "examples": [
        "doc_8f3a1c2b9e4d"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the insurance policy.",
      "examples": [
        "doc_1a2b3c4d5e6f"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the appliance.",
      "examples": [
        "Extended warranty purchased in-store, receipt in the kitchen drawer."
      ]
    }
  },
  "required": [
    "name"
  ],
  "examples": [
    {
      "name": "Kitchen Refrigerator",
      "brand": "Samsung",
      "model": "RF28R7351SG",
      "serialNumber": "S/N-4471829",
      "purchaseDate": "2023-11-04",
      "warrantyExpiryDate": "2025-11-04"
    }
  ]
}

update_appliance

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.

Parameters10

id	string	required	ID of the appliance to update.
name	string	optional	New name for the appliance. Omit to leave unchanged.
brand	string	optional	New manufacturer or brand name. Omit to leave unchanged.
model	string	optional	New model name or number. Omit to leave unchanged.
serialNumber	string	optional	New manufacturer serial number. Omit to leave unchanged.
purchaseDate	string	optional	Date the appliance was purchased, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it. Must not be after warrantyExpiryDate.
warrantyExpiryDate	string	optional	Date the manufacturer warranty expires, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it. Must not be before purchaseDate.
warrantyDocumentId	string	optional	ID of a previously created document containing the warranty paperwork. Omit to leave unchanged.
insuranceDocumentId	string	optional	ID of a previously created document containing the insurance policy. Omit to leave unchanged.
notes	string	optional	Freeform notes about the appliance. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the appliance to update.",
      "examples": [
        "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
      ]
    },
    "name": {
      "type": "string",
      "description": "New name for the appliance. Omit to leave unchanged.",
      "examples": [
        "Kitchen Refrigerator"
      ]
    },
    "brand": {
      "type": "string",
      "description": "New manufacturer or brand name. Omit to leave unchanged.",
      "examples": [
        "Samsung"
      ]
    },
    "model": {
      "type": "string",
      "description": "New model name or number. Omit to leave unchanged.",
      "examples": [
        "RF28R7351SG"
      ]
    },
    "serialNumber": {
      "type": "string",
      "description": "New manufacturer serial number. Omit to leave unchanged.",
      "examples": [
        "S/N-4471829"
      ]
    },
    "purchaseDate": {
      "type": "string",
      "description": "Date the appliance was purchased, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it. Must not be after warrantyExpiryDate.",
      "examples": [
        "2023-11-04"
      ]
    },
    "warrantyExpiryDate": {
      "type": "string",
      "description": "Date the manufacturer warranty expires, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it. Must not be before purchaseDate.",
      "examples": [
        "2025-11-04"
      ]
    },
    "warrantyDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the warranty paperwork. Omit to leave unchanged.",
      "examples": [
        "doc_8f3a1c2b9e4d"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the insurance policy. Omit to leave unchanged.",
      "examples": [
        "doc_1a2b3c4d5e6f"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the appliance. Omit to leave unchanged.",
      "examples": [
        "Extended warranty purchased in-store, receipt in the kitchen drawer."
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f",
      "warrantyExpiryDate": "2026-11-04",
      "notes": "Repaired ice maker under warranty, June 2026."
    }
  ]
}

delete_appliance

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

Parameters1

string

required

ID of the appliance to delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the appliance to delete.",
      "examples": [
        "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
    }
  ]
}

list_appliances

List all appliances in the household

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "description": "Takes no parameters; returns every non-deleted appliance in the caller's household.",
  "examples": [
    {}
  ]
}

create_calendar_event

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

Parameters8

title	string	required	Event title/summary shown in calendar views. Required, up to 200 characters.
description	string	optional	Longer free-text description of the event. Up to 2000 characters.
location	object	optional	Location. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).
startDateTime	string	required	ISO 8601 date-time in UTC (Z-suffix). The wall clock is interpreted against the supplied timezone if any.
endDateTime	string	optional	ISO 8601 date-time in UTC (Z-suffix). Must not be before startDateTime.
isAllDay	boolean	required	True for an all-day event with no specific start/end time; false for a timed event.
notes	string	optional	Freeform notes attached to the event. Up to 5000 characters.
timezone	string \| null	optional	IANA timezone id (e.g. 'Europe/London') describing the wall-clock zone of startDateTime/endDateTime; null = UTC.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Event title/summary shown in calendar views. Required, up to 200 characters.",
      "examples": [
        "Dentist appointment"
      ]
    },
    "description": {
      "type": "string",
      "description": "Longer free-text description of the event. Up to 2000 characters.",
      "examples": [
        "Annual checkup with Dr. Smith"
      ]
    },
    "location": {
      "type": "object",
      "description": "Location. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).",
      "properties": {
        "$type": {
          "type": "string",
          "enum": [
            "Address",
            "OnlineLocation"
          ],
          "description": "Location type discriminator"
        },
        "line1": {
          "type": "string",
          "description": "First line of the street address (Address type). At least one of line1-3/postalCode is required when $type is 'Address'.",
          "examples": [
            "221B Baker Street"
          ]
        },
        "line2": {
          "type": "string",
          "description": "Second line of the street address (Address type), e.g. building or suite.",
          "examples": [
            "Flat 3"
          ]
        },
        "line3": {
          "type": "string",
          "description": "Third line of the street address (Address type)."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code (Address type). Up to 20 characters.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code for the address (Address type).",
          "examples": [
            "GB"
          ]
        },
        "url": {
          "type": "string",
          "description": "URL for online locations (OnlineLocation type). Must be an absolute http/https URL.",
          "examples": [
            "https://meet.google.com/abc-defg-hij"
          ]
        },
        "notes": {
          "type": "string",
          "description": "Notes about the location, e.g. parking instructions or a meeting passcode. Up to 500 characters for OnlineLocation."
        }
      },
      "required": [
        "$type"
      ]
    },
    "startDateTime": {
      "type": "string",
      "description": "ISO 8601 date-time in UTC (Z-suffix). The wall clock is interpreted against the supplied timezone if any.",
      "examples": [
        "2026-08-03T14:30:00Z"
      ]
    },
    "endDateTime": {
      "type": "string",
      "description": "ISO 8601 date-time in UTC (Z-suffix). Must not be before startDateTime.",
      "examples": [
        "2026-08-03T15:30:00Z"
      ]
    },
    "isAllDay": {
      "type": "boolean",
      "description": "True for an all-day event with no specific start/end time; false for a timed event.",
      "examples": [
        false
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes attached to the event. Up to 5000 characters.",
      "examples": [
        "Bring insurance card"
      ]
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone id (e.g. 'Europe/London') describing the wall-clock zone of startDateTime/endDateTime; null = UTC.",
      "examples": [
        "Europe/London"
      ]
    }
  },
  "required": [
    "title",
    "startDateTime",
    "isAllDay"
  ],
  "examples": [
    {
      "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"
    }
  ]
}

update_calendar_event

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.

Parameters9

id	string	required	Id of the calendar event to update.
title	string	optional	New event title/summary. Omit to leave unchanged. Up to 200 characters.
description	string	optional	New longer free-text description of the event. Omit to leave unchanged. Up to 2000 characters.
location	object	optional	New location, replacing the existing one entirely. Omit to leave unchanged. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).
startDateTime	string	optional	New start date-time, ISO 8601 in UTC (Z-suffix). Wall clock is interpreted against the supplied timezone if any. Omit to leave unchanged.
endDateTime	string	optional	New end date-time, ISO 8601 in UTC (Z-suffix). Must not be before startDateTime. Omit to leave unchanged.
isAllDay	boolean	optional	True for an all-day event with no specific start/end time; false for a timed event. Omit to leave unchanged.
notes	string	optional	New freeform notes attached to the event. Omit to leave unchanged. Up to 5000 characters.
timezone	string \| null	optional	IANA timezone id (e.g. 'Europe/London') describing the wall-clock zone of startDateTime/endDateTime; null = UTC. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id of the calendar event to update.",
      "examples": [
        "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
      ]
    },
    "title": {
      "type": "string",
      "description": "New event title/summary. Omit to leave unchanged. Up to 200 characters.",
      "examples": [
        "Dentist appointment (rescheduled)"
      ]
    },
    "description": {
      "type": "string",
      "description": "New longer free-text description of the event. Omit to leave unchanged. Up to 2000 characters."
    },
    "location": {
      "type": "object",
      "description": "New location, replacing the existing one entirely. Omit to leave unchanged. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).",
      "properties": {
        "$type": {
          "type": "string",
          "enum": [
            "Address",
            "OnlineLocation"
          ],
          "description": "Location type discriminator"
        },
        "line1": {
          "type": "string",
          "description": "First line of the street address (Address type). At least one of line1-3/postalCode is required when $type is 'Address'.",
          "examples": [
            "221B Baker Street"
          ]
        },
        "line2": {
          "type": "string",
          "description": "Second line of the street address (Address type), e.g. building or suite."
        },
        "line3": {
          "type": "string",
          "description": "Third line of the street address (Address type)."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code (Address type). Up to 20 characters.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code for the address (Address type).",
          "examples": [
            "GB"
          ]
        },
        "url": {
          "type": "string",
          "description": "URL for online locations (OnlineLocation type). Must be an absolute http/https URL."
        },
        "notes": {
          "type": "string",
          "description": "Notes about the location, e.g. parking instructions or a meeting passcode. Up to 500 characters for OnlineLocation."
        }
      },
      "required": [
        "$type"
      ]
    },
    "startDateTime": {
      "type": "string",
      "description": "New start date-time, ISO 8601 in UTC (Z-suffix). Wall clock is interpreted against the supplied timezone if any. Omit to leave unchanged.",
      "examples": [
        "2026-08-04T14:30:00Z"
      ]
    },
    "endDateTime": {
      "type": "string",
      "description": "New end date-time, ISO 8601 in UTC (Z-suffix). Must not be before startDateTime. Omit to leave unchanged.",
      "examples": [
        "2026-08-04T15:30:00Z"
      ]
    },
    "isAllDay": {
      "type": "boolean",
      "description": "True for an all-day event with no specific start/end time; false for a timed event. Omit to leave unchanged."
    },
    "notes": {
      "type": "string",
      "description": "New freeform notes attached to the event. Omit to leave unchanged. Up to 5000 characters."
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone id (e.g. 'Europe/London') describing the wall-clock zone of startDateTime/endDateTime; null = UTC. Omit to leave unchanged.",
      "examples": [
        "Europe/London"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198f3a1b2c34d5e6f7089ab1c2d3e4f",
      "startDateTime": "2026-08-04T14:30:00Z",
      "endDateTime": "2026-08-04T15:30:00Z",
      "notes": "Moved to Thursday"
    }
  ]
}

delete_calendar_event

Soft-deletes a single calendar event by id. Events imported from a calendar subscription cannot be deleted here; unsubscribe from the source calendar instead.

Parameters1

string

required

Id of the calendar event to delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id of the calendar event to delete.",
      "examples": [
        "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
    }
  ]
}

list_calendar_events

List calendar events with optional date-range filters

Parameters2

startDateFrom	string	optional	Inclusive lower bound of the date range, ISO 8601 date-time in UTC. An event matches if it ends (or, when it has no end, starts) on or after this instant. Omit for no lower bound.
startDateTo	string	optional	Inclusive upper bound of the date range, ISO 8601 date-time in UTC. An event matches if it starts on or before this instant. Omit for no upper bound.

Raw schema

{
  "type": "object",
  "properties": {
    "startDateFrom": {
      "type": "string",
      "description": "Inclusive lower bound of the date range, ISO 8601 date-time in UTC. An event matches if it ends (or, when it has no end, starts) on or after this instant. Omit for no lower bound.",
      "examples": [
        "2026-07-01T00:00:00Z"
      ]
    },
    "startDateTo": {
      "type": "string",
      "description": "Inclusive upper bound of the date range, ISO 8601 date-time in UTC. An event matches if it starts on or before this instant. Omit for no upper bound.",
      "examples": [
        "2026-07-31T23:59:59Z"
      ]
    }
  },
  "required": [],
  "examples": [
    {
      "startDateFrom": "2026-07-01T00:00:00Z",
      "startDateTo": "2026-07-31T23:59:59Z"
    }
  ]
}

create_document

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

Parameters7

documentType	string	required	The kind of document being stored.
title	string	optional	A custom title for the document. If omitted, one is derived from the document type and number, e.g. 'Passport - 512345678'.
documentNumber	string	optional	The document's reference or serial number, e.g. a passport number or insurance policy number.
issuingAuthority	string	optional	The organization or authority that issued the document.
renewalCronExpression	string	optional	Reserved for a future renewal-reminder schedule. Currently accepted but not persisted or acted on by document creation — has no effect yet.
fee	object	optional	The cost associated with the document, e.g. a renewal or issuance fee.
notes	string	optional	Free-text notes about the document.

Raw schema

{
  "type": "object",
  "properties": {
    "documentType": {
      "type": "string",
      "description": "The kind of document being stored.",
      "enum": [
        "Passport",
        "Insurance",
        "Certificate",
        "Warranty",
        "License",
        "Other"
      ],
      "examples": [
        "Passport"
      ]
    },
    "title": {
      "type": "string",
      "description": "A custom title for the document. If omitted, one is derived from the document type and number, e.g. 'Passport - 512345678'.",
      "examples": [
        "UK Passport"
      ]
    },
    "documentNumber": {
      "type": "string",
      "description": "The document's reference or serial number, e.g. a passport number or insurance policy number.",
      "examples": [
        "512345678"
      ]
    },
    "issuingAuthority": {
      "type": "string",
      "description": "The organization or authority that issued the document.",
      "examples": [
        "HM Passport Office"
      ]
    },
    "renewalCronExpression": {
      "type": "string",
      "description": "Reserved for a future renewal-reminder schedule. Currently accepted but not persisted or acted on by document creation — has no effect yet."
    },
    "fee": {
      "type": "object",
      "description": "The cost associated with the document, e.g. a renewal or issuance fee.",
      "properties": {
        "value": {
          "type": "integer",
          "description": "Amount in smallest currency unit",
          "examples": [
            8250
          ]
        },
        "currencyCode": {
          "type": "string",
          "description": "ISO 4217 code",
          "examples": [
            "GBP"
          ]
        }
      },
      "required": [
        "value",
        "currencyCode"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the document."
    }
  },
  "required": [
    "documentType"
  ],
  "examples": [
    {
      "documentType": "Passport",
      "title": "UK Passport",
      "documentNumber": "512345678",
      "issuingAuthority": "HM Passport Office",
      "fee": {
        "value": 8250,
        "currencyCode": "GBP"
      },
      "notes": "Renew before the next family trip."
    }
  ]
}

update_document

Update a document. Omitted fields unchanged.

Parameters8

id	string	required	The id of the document to update, as returned by create_document or list_documents.
documentType	string	optional	The kind of document being stored. Omit to leave unchanged.
title	string	optional	A custom title for the document. Omit to leave unchanged.
documentNumber	string	optional	The document's reference or serial number, e.g. a passport number or insurance policy number. Omit to leave unchanged.
issuingAuthority	string	optional	The organization or authority that issued the document. Omit to leave unchanged.
renewalCronExpression	string	optional	Reserved for a future renewal-reminder schedule. Currently accepted but not persisted or acted on by document updates — has no effect yet.
fee	object	optional	The cost associated with the document, e.g. a renewal or issuance fee. Omit to leave unchanged; when supplied, replaces the whole fee.
notes	string	optional	Free-text notes about the document. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the document to update, as returned by create_document or list_documents.",
      "examples": [
        "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
      ]
    },
    "documentType": {
      "type": "string",
      "description": "The kind of document being stored. Omit to leave unchanged.",
      "enum": [
        "Passport",
        "Insurance",
        "Certificate",
        "Warranty",
        "License",
        "Other"
      ],
      "examples": [
        "Passport"
      ]
    },
    "title": {
      "type": "string",
      "description": "A custom title for the document. Omit to leave unchanged.",
      "examples": [
        "UK Passport"
      ]
    },
    "documentNumber": {
      "type": "string",
      "description": "The document's reference or serial number, e.g. a passport number or insurance policy number. Omit to leave unchanged.",
      "examples": [
        "512345678"
      ]
    },
    "issuingAuthority": {
      "type": "string",
      "description": "The organization or authority that issued the document. Omit to leave unchanged.",
      "examples": [
        "HM Passport Office"
      ]
    },
    "renewalCronExpression": {
      "type": "string",
      "description": "Reserved for a future renewal-reminder schedule. Currently accepted but not persisted or acted on by document updates — has no effect yet."
    },
    "fee": {
      "type": "object",
      "description": "The cost associated with the document, e.g. a renewal or issuance fee. Omit to leave unchanged; when supplied, replaces the whole fee.",
      "properties": {
        "value": {
          "type": "integer",
          "description": "Amount in smallest currency unit",
          "examples": [
            8250
          ]
        },
        "currencyCode": {
          "type": "string",
          "description": "ISO 4217 code",
          "examples": [
            "GBP"
          ]
        }
      },
      "required": [
        "value",
        "currencyCode"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the document. Omit to leave unchanged."
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01928e4a7d3f7b9ac1e3f6d8b2a4c710",
      "issuingAuthority": "HM Passport Office",
      "notes": "Renewed for another 10 years."
    }
  ]
}

delete_document

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.

Parameters1

string

required

The id of the document to delete, as returned by create_document or list_documents.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the document to delete, as returned by create_document or list_documents.",
      "examples": [
        "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01928e4a7d3f7b9ac1e3f6d8b2a4c710"
    }
  ]
}

list_documents

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

Parameters1

documentType

string

optional

Optional filter to only return documents of this type. Omit to return documents of all types.

Raw schema

{
  "type": "object",
  "properties": {
    "documentType": {
      "type": "string",
      "description": "Optional filter to only return documents of this type. Omit to return documents of all types.",
      "enum": [
        "Passport",
        "Insurance",
        "Certificate",
        "Warranty",
        "License",
        "Other"
      ],
      "examples": [
        "Passport"
      ]
    }
  },
  "examples": [
    {},
    {
      "documentType": "Passport"
    }
  ]
}

create_pet

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

Parameters6

name	string	required	The pet's name.
microchipNumber	string	optional	Microchip identification number, used to reunite a lost pet with its household.
vetContactId	string	optional	ID of a previously created contact for the pet's vet.
insuranceDocumentId	string	optional	ID of a previously created document containing the pet's insurance policy.
notes	string	optional	Freeform notes about the pet, e.g. dietary needs or medical history.
dateOfBirth	string	optional	The pet's date of birth, in YYYY-MM-DD format.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The pet's name.",
      "examples": [
        "Bella"
      ]
    },
    "microchipNumber": {
      "type": "string",
      "description": "Microchip identification number, used to reunite a lost pet with its household.",
      "examples": [
        "985141000123456"
      ]
    },
    "vetContactId": {
      "type": "string",
      "description": "ID of a previously created contact for the pet's vet.",
      "examples": [
        "contact_5e6f7a8b9c0d"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the pet's insurance policy.",
      "examples": [
        "doc_1a2b3c4d5e6f"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the pet, e.g. dietary needs or medical history.",
      "examples": [
        "Allergic to chicken; on prescription food."
      ]
    },
    "dateOfBirth": {
      "type": "string",
      "description": "The pet's date of birth, in YYYY-MM-DD format.",
      "examples": [
        "2021-06-15"
      ]
    }
  },
  "required": [
    "name"
  ],
  "examples": [
    {
      "name": "Bella",
      "microchipNumber": "985141000123456",
      "dateOfBirth": "2021-06-15",
      "notes": "Allergic to chicken; on prescription food."
    }
  ]
}

update_pet

Update a pet. Omitted fields unchanged.

Parameters7

id	string	required	ID of the pet to update.
name	string	optional	New name for the pet. Omit to leave unchanged.
microchipNumber	string	optional	New microchip identification number. Omit to leave unchanged.
vetContactId	string	optional	ID of a previously created contact for the pet's vet. Omit to leave unchanged.
insuranceDocumentId	string	optional	ID of a previously created document containing the pet's insurance policy. Omit to leave unchanged.
notes	string	optional	Freeform notes about the pet. Omit to leave unchanged.
dateOfBirth	string	optional	The pet's date of birth, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the pet to update.",
      "examples": [
        "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
      ]
    },
    "name": {
      "type": "string",
      "description": "New name for the pet. Omit to leave unchanged.",
      "examples": [
        "Bella"
      ]
    },
    "microchipNumber": {
      "type": "string",
      "description": "New microchip identification number. Omit to leave unchanged.",
      "examples": [
        "985141000123456"
      ]
    },
    "vetContactId": {
      "type": "string",
      "description": "ID of a previously created contact for the pet's vet. Omit to leave unchanged.",
      "examples": [
        "contact_5e6f7a8b9c0d"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "ID of a previously created document containing the pet's insurance policy. Omit to leave unchanged.",
      "examples": [
        "doc_1a2b3c4d5e6f"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the pet. Omit to leave unchanged.",
      "examples": [
        "Allergic to chicken; on prescription food."
      ]
    },
    "dateOfBirth": {
      "type": "string",
      "description": "The pet's date of birth, in YYYY-MM-DD format. Omit or send null to leave unchanged, send an empty string to clear it.",
      "examples": [
        "2021-06-15"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f",
      "notes": "Started prescription diet on vet's advice."
    }
  ]
}

delete_pet

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

Parameters1

string

required

ID of the pet to delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the pet to delete.",
      "examples": [
        "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "01933f9c-7a2b-7c3d-8e4f-1a2b3c4d5e6f"
    }
  ]
}

list_pets

List all pets in the household

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "description": "Takes no parameters; returns every non-deleted pet in the caller's household.",
  "examples": [
    {}
  ]
}

create_subscription

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.

Parameters6

name	string	required	Display name of the subscription, e.g. 'Netflix' or 'Gym membership'.
status	string	required	Lifecycle status of the subscription at creation time.
renewalCronExpression	string	optional	Cron expression describing how often the subscription renews. Must not repeat more frequently than once a day.
fee	object	optional	The recurring charge for this subscription.
notes	string	optional	Free-text notes about the subscription.
remindMe	boolean	optional	Whether to send renewal reminders for this subscription

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name of the subscription, e.g. 'Netflix' or 'Gym membership'."
    },
    "status": {
      "type": "string",
      "enum": [
        "Active",
        "Paused",
        "Cancelled"
      ],
      "description": "Lifecycle status of the subscription at creation time."
    },
    "renewalCronExpression": {
      "type": "string",
      "description": "Cron expression describing how often the subscription renews. Must not repeat more frequently than once a day.",
      "examples": [
        "0 0 1 * *"
      ]
    },
    "fee": {
      "type": "object",
      "description": "The recurring charge for this subscription.",
      "properties": {
        "value": {
          "type": "integer",
          "description": "Amount in the smallest currency unit (e.g. cents for USD).",
          "examples": [
            1599
          ]
        },
        "currencyCode": {
          "type": "string",
          "description": "ISO 4217 currency code (3 letters).",
          "examples": [
            "USD"
          ]
        }
      }
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the subscription."
    },
    "remindMe": {
      "type": "boolean",
      "description": "Whether to send renewal reminders for this subscription"
    }
  },
  "required": [
    "name",
    "status"
  ],
  "examples": [
    {
      "name": "Netflix",
      "status": "Active",
      "renewalCronExpression": "0 0 1 * *",
      "fee": {
        "value": 1599,
        "currencyCode": "USD"
      },
      "notes": "Family plan, shared with parents",
      "remindMe": true
    }
  ]
}

update_subscription

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.

Parameters7

id	string	required	ID of the subscription to update.
name	string	optional	Display name of the subscription. Omit to leave unchanged.
status	string	optional	New lifecycle status for the subscription. Omit to leave unchanged.
renewalCronExpression	string	optional	Cron expression describing how often the subscription renews. Must not repeat more frequently than once a day. Omit to leave unchanged, or send an empty string to clear the renewal schedule.
fee	object	optional	The recurring charge for this subscription. Omit to leave unchanged.
notes	string	optional	Free-text notes about the subscription. Omit to leave unchanged, or send an empty string to clear the notes.
remindMe	boolean	optional	Whether to send renewal reminders for this subscription

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the subscription to update.",
      "examples": [
        "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
      ]
    },
    "name": {
      "type": "string",
      "description": "Display name of the subscription. Omit to leave unchanged."
    },
    "status": {
      "type": "string",
      "enum": [
        "Active",
        "Paused",
        "Cancelled"
      ],
      "description": "New lifecycle status for the subscription. Omit to leave unchanged."
    },
    "renewalCronExpression": {
      "type": "string",
      "description": "Cron expression describing how often the subscription renews. Must not repeat more frequently than once a day. Omit to leave unchanged, or send an empty string to clear the renewal schedule.",
      "examples": [
        "0 0 1 * *"
      ]
    },
    "fee": {
      "type": "object",
      "description": "The recurring charge for this subscription. Omit to leave unchanged.",
      "properties": {
        "value": {
          "type": "integer",
          "description": "Amount in the smallest currency unit (e.g. cents for USD).",
          "examples": [
            1599
          ]
        },
        "currencyCode": {
          "type": "string",
          "description": "ISO 4217 currency code (3 letters).",
          "examples": [
            "USD"
          ]
        }
      }
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the subscription. Omit to leave unchanged, or send an empty string to clear the notes."
    },
    "remindMe": {
      "type": "boolean",
      "description": "Whether to send renewal reminders for this subscription"
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e",
      "status": "Paused",
      "notes": "Paused while travelling"
    }
  ]
}

delete_subscription

Soft-delete a subscription

Parameters1

string

required

ID of the subscription to soft-delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the subscription to soft-delete.",
      "examples": [
        "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
    }
  ]
}

list_subscriptions

List subscriptions with optional status filter

Parameters1

status

string

optional

Only return subscriptions with this status. Omit to return subscriptions of all statuses.

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "Active",
        "Paused",
        "Cancelled"
      ],
      "description": "Only return subscriptions with this status. Omit to return subscriptions of all statuses."
    }
  },
  "examples": [
    {
      "status": "Active"
    }
  ]
}

create_vehicle

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.

Parameters11

make	string	optional	Manufacturer of the vehicle, e.g. 'Toyota'.
model	string	optional	Model name of the vehicle, e.g. 'Corolla'.
year	integer	optional	Model year of the vehicle. Must be between 1900 and 2100.
registration	string	optional	The vehicle's registration/licence plate as shown on the plate. Free-text; format varies by country.
vin	string	optional	Vehicle Identification Number: a 17-character alphanumeric code unique to the vehicle.
colour	string	optional	Colour of the vehicle.
insuranceDocumentId	string	optional	Document ID of insurance policy
motDueDate	string	optional	Date the next MOT (roadworthiness test) is due, in YYYY-MM-DD format.
taxDueDate	string	optional	Date the vehicle's road tax is next due, in YYYY-MM-DD format.
serviceDueDate	string	optional	Date the vehicle's next scheduled service is due, in YYYY-MM-DD format.
notes	string	optional	Free-text notes about the vehicle.

Raw schema

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "description": "Manufacturer of the vehicle, e.g. 'Toyota'.",
      "examples": [
        "Toyota"
      ]
    },
    "model": {
      "type": "string",
      "description": "Model name of the vehicle, e.g. 'Corolla'.",
      "examples": [
        "Corolla"
      ]
    },
    "year": {
      "type": "integer",
      "description": "Model year of the vehicle. Must be between 1900 and 2100.",
      "examples": [
        2021
      ]
    },
    "registration": {
      "type": "string",
      "description": "The vehicle's registration/licence plate as shown on the plate. Free-text; format varies by country.",
      "examples": [
        "AB21 CDE"
      ]
    },
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number: a 17-character alphanumeric code unique to the vehicle.",
      "examples": [
        "1HGCM82633A004352"
      ]
    },
    "colour": {
      "type": "string",
      "description": "Colour of the vehicle.",
      "examples": [
        "Blue"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "Document ID of insurance policy"
    },
    "motDueDate": {
      "type": "string",
      "description": "Date the next MOT (roadworthiness test) is due, in YYYY-MM-DD format.",
      "examples": [
        "2026-11-15"
      ]
    },
    "taxDueDate": {
      "type": "string",
      "description": "Date the vehicle's road tax is next due, in YYYY-MM-DD format.",
      "examples": [
        "2026-09-01"
      ]
    },
    "serviceDueDate": {
      "type": "string",
      "description": "Date the vehicle's next scheduled service is due, in YYYY-MM-DD format.",
      "examples": [
        "2027-01-20"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the vehicle."
    }
  },
  "required": [],
  "examples": [
    {
      "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"
    }
  ]
}

update_vehicle

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.

Parameters12

id	string	required	ID of the vehicle to update.
make	string	optional	Manufacturer of the vehicle, e.g. 'Toyota'. Omit to leave unchanged, or send an empty string to clear it.
model	string	optional	Model name of the vehicle, e.g. 'Corolla'. Omit to leave unchanged, or send an empty string to clear it.
year	integer	optional	Model year of the vehicle. Must be between 1900 and 2100. Omit to leave unchanged.
registration	string	optional	The vehicle's registration/licence plate as shown on the plate. Free-text; format varies by country. Omit to leave unchanged, or send an empty string to clear it.
vin	string	optional	Vehicle Identification Number: a 17-character alphanumeric code unique to the vehicle. Omit to leave unchanged, or send an empty string to clear it.
colour	string	optional	Colour of the vehicle. Omit to leave unchanged, or send an empty string to clear it.
insuranceDocumentId	string	optional	Document ID of the associated insurance policy document. Omit to leave unchanged, or send an empty string to clear it.
motDueDate	string	optional	Date the next MOT (roadworthiness test) is due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.
taxDueDate	string	optional	Date the vehicle's road tax is next due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.
serviceDueDate	string	optional	Date the vehicle's next scheduled service is due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.
notes	string	optional	Free-text notes about the vehicle. Omit to leave unchanged, or send an empty string to clear it.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the vehicle to update.",
      "examples": [
        "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
      ]
    },
    "make": {
      "type": "string",
      "description": "Manufacturer of the vehicle, e.g. 'Toyota'. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "Toyota"
      ]
    },
    "model": {
      "type": "string",
      "description": "Model name of the vehicle, e.g. 'Corolla'. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "Corolla"
      ]
    },
    "year": {
      "type": "integer",
      "description": "Model year of the vehicle. Must be between 1900 and 2100. Omit to leave unchanged.",
      "examples": [
        2021
      ]
    },
    "registration": {
      "type": "string",
      "description": "The vehicle's registration/licence plate as shown on the plate. Free-text; format varies by country. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "AB21 CDE"
      ]
    },
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number: a 17-character alphanumeric code unique to the vehicle. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "1HGCM82633A004352"
      ]
    },
    "colour": {
      "type": "string",
      "description": "Colour of the vehicle. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "Blue"
      ]
    },
    "insuranceDocumentId": {
      "type": "string",
      "description": "Document ID of the associated insurance policy document. Omit to leave unchanged, or send an empty string to clear it."
    },
    "motDueDate": {
      "type": "string",
      "description": "Date the next MOT (roadworthiness test) is due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "2026-11-15"
      ]
    },
    "taxDueDate": {
      "type": "string",
      "description": "Date the vehicle's road tax is next due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "2026-09-01"
      ]
    },
    "serviceDueDate": {
      "type": "string",
      "description": "Date the vehicle's next scheduled service is due, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it.",
      "examples": [
        "2027-01-20"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes about the vehicle. Omit to leave unchanged, or send an empty string to clear it."
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e",
      "taxDueDate": "2027-09-01",
      "notes": "Renewed tax disc"
    }
  ]
}

delete_vehicle

Soft-delete a vehicle

Parameters1

string

required

ID of the vehicle to soft-delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the vehicle to soft-delete.",
      "examples": [
        "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198c1f4b2c07a1b9e4d5f6a7b8c9d0e"
    }
  ]
}

list_vehicles

List all vehicles in the household

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "examples": [
    {}
  ]
}

create_task

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.

Parameters5

title	string	required	The task's title, e.g. 'Take out the recycling'. Required; max 200 characters.
assignedToMemberId	string	optional	The member ID of the household member. Get this from list_house_members.
dueDate	string	optional	The date the task is due, in YYYY-MM-DD format.
preparationDate	string	optional	The date to start preparing for the task, in YYYY-MM-DD format. Must be on or before the due date if both are set.
notes	string	optional	Freeform notes about the task. Not for assignment info.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The task's title, e.g. 'Take out the recycling'. Required; max 200 characters.",
      "examples": [
        "Take out the recycling"
      ]
    },
    "assignedToMemberId": {
      "type": "string",
      "description": "The member ID of the household member. Get this from list_house_members.",
      "examples": [
        "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
      ]
    },
    "dueDate": {
      "type": "string",
      "description": "The date the task is due, in YYYY-MM-DD format.",
      "examples": [
        "2026-08-01"
      ]
    },
    "preparationDate": {
      "type": "string",
      "description": "The date to start preparing for the task, in YYYY-MM-DD format. Must be on or before the due date if both are set.",
      "examples": [
        "2026-07-30"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the task. Not for assignment info."
    }
  },
  "required": [
    "title"
  ],
  "examples": [
    {
      "title": "Take out the recycling",
      "assignedToMemberId": "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e",
      "dueDate": "2026-08-01",
      "preparationDate": "2026-07-30",
      "notes": "Blue bin only"
    }
  ]
}

update_task

Update task title, assignment, dates, or notes.

Parameters6

id	string	required	The task's ID, as returned by create_task or list_tasks.
title	string	optional	New title for the task. Omit to leave unchanged; max 200 characters.
assignedToMemberId	string	optional	Member ID to assign, or empty string to unassign. Omit to leave the current assignment unchanged.
dueDate	string	optional	YYYY-MM-DD format, or empty string to clear. Omit to leave unchanged.
preparationDate	string	optional	YYYY-MM-DD format, or empty string to clear. Omit to leave unchanged.
notes	string	optional	Freeform notes about the task. Not for assignment info. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The task's ID, as returned by create_task or list_tasks.",
      "examples": [
        "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
      ]
    },
    "title": {
      "type": "string",
      "description": "New title for the task. Omit to leave unchanged; max 200 characters."
    },
    "assignedToMemberId": {
      "type": "string",
      "description": "Member ID to assign, or empty string to unassign. Omit to leave the current assignment unchanged.",
      "examples": [
        "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
      ]
    },
    "dueDate": {
      "type": "string",
      "description": "YYYY-MM-DD format, or empty string to clear. Omit to leave unchanged.",
      "examples": [
        "2026-08-01"
      ]
    },
    "preparationDate": {
      "type": "string",
      "description": "YYYY-MM-DD format, or empty string to clear. Omit to leave unchanged.",
      "examples": [
        "2026-07-30"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes about the task. Not for assignment info. Omit to leave unchanged."
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a",
      "title": "Take out the recycling",
      "dueDate": "2026-08-01"
    }
  ]
}

delete_task

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.

Parameters1

string

required

The task's ID, as returned by create_task or list_tasks.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The task's ID, as returned by create_task or list_tasks.",
      "examples": [
        "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
    }
  ]
}

complete_task

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.

Parameters1

string

required

The task's ID, as returned by create_task or list_tasks.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The task's ID, as returned by create_task or list_tasks.",
      "examples": [
        "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
    }
  ]
}

uncomplete_task

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

Parameters1

string

required

The task's ID, as returned by create_task or list_tasks.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The task's ID, as returned by create_task or list_tasks.",
      "examples": [
        "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
    }
  ]
}

assign_task

Assign or unassign a task to a household member.

Parameters2

id	string	required	The task's ID, as returned by create_task or list_tasks.
assignedToMemberId	string	optional	The member ID of the household member. Get this from list_house_members. Pass null or empty string to unassign.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The task's ID, as returned by create_task or list_tasks.",
      "examples": [
        "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a"
      ]
    },
    "assignedToMemberId": {
      "type": "string",
      "description": "The member ID of the household member. Get this from list_house_members. Pass null or empty string to unassign.",
      "examples": [
        "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a",
      "assignedToMemberId": "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
    }
  ]
}

list_tasks

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.

Parameters6

assignedToMemberId	string	optional	Filter to tasks assigned to this household member ID. Omit to include tasks for all assignees.
includeCompleted	boolean	optional	Whether to include completed tasks in the results. Default: false
dueDateOnOrAfter	string	optional	Only include tasks with a due date on or after this date (YYYY-MM-DD). Tasks with no due date never match.
dueDateOnOrBefore	string	optional	Only include tasks with a due date on or before this date (YYYY-MM-DD). Tasks with no due date never match.
limit	integer	optional	Maximum number of tasks to return per page. 1-100, default 50.
cursor	string	optional	Opaque pagination cursor from a previous list_tasks response's nextCursor. Omit to fetch the first page.

Raw schema

{
  "type": "object",
  "properties": {
    "assignedToMemberId": {
      "type": "string",
      "description": "Filter to tasks assigned to this household member ID. Omit to include tasks for all assignees.",
      "examples": [
        "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
      ]
    },
    "includeCompleted": {
      "type": "boolean",
      "description": "Whether to include completed tasks in the results. Default: false"
    },
    "dueDateOnOrAfter": {
      "type": "string",
      "description": "Only include tasks with a due date on or after this date (YYYY-MM-DD). Tasks with no due date never match.",
      "examples": [
        "2026-07-01"
      ]
    },
    "dueDateOnOrBefore": {
      "type": "string",
      "description": "Only include tasks with a due date on or before this date (YYYY-MM-DD). Tasks with no due date never match.",
      "examples": [
        "2026-07-31"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of tasks to return per page. 1-100, default 50."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from a previous list_tasks response's nextCursor. Omit to fetch the first page."
    }
  },
  "examples": [
    {
      "assignedToMemberId": "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e",
      "includeCompleted": false,
      "dueDateOnOrAfter": "2026-07-01",
      "dueDateOnOrBefore": "2026-07-31",
      "limit": 20
    }
  ]
}

get_weather_forecast

Get weather forecast for the household's location

Parameters1

forecastDays

integer

optional

Number of forecast days to return, from 1 to 5. Defaults to 3 if omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "forecastDays": {
      "type": "integer",
      "description": "Number of forecast days to return, from 1 to 5. Defaults to 3 if omitted.",
      "examples": [
        3
      ]
    }
  },
  "examples": [
    {
      "forecastDays": 3
    }
  ]
}

get_house

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "examples": [
    {}
  ]
}

list_house_members

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "examples": [
    {}
  ]
}

list_houses

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "examples": [
    {}
  ]
}

get_profile

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "examples": [
    {}
  ]
}

list_shopping_list_items

List all shopping list items in the household

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "description": "No parameters. Returns the active (not yet bought) items on the current household's shopping list.",
  "examples": [
    {}
  ]
}

add_shopping_list_item

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.

Parameters2

name	string	required	The name of the item to add, e.g. 'Milk' or 'Paper towels'. Maximum 200 characters. For a brand-new item, a category is auto-assigned from the name. If an unbought item with a matching name is already on the list, its quantity is increased instead of creating a duplicate entry, and the existing item keeps its current category unchanged.
quantity	integer	optional	How many of the item to add. Defaults to 1 if omitted. Minimum 1, maximum 9999. When merged into an existing unbought item, this is added to the existing quantity (capped at 9999).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The name of the item to add, e.g. 'Milk' or 'Paper towels'. Maximum 200 characters. For a brand-new item, a category is auto-assigned from the name. If an unbought item with a matching name is already on the list, its quantity is increased instead of creating a duplicate entry, and the existing item keeps its current category unchanged.",
      "examples": [
        "Milk"
      ]
    },
    "quantity": {
      "type": "integer",
      "description": "How many of the item to add. Defaults to 1 if omitted. Minimum 1, maximum 9999. When merged into an existing unbought item, this is added to the existing quantity (capped at 9999).",
      "examples": [
        2
      ]
    }
  },
  "required": [
    "name"
  ],
  "examples": [
    {
      "name": "Milk",
      "quantity": 2
    }
  ]
}

buy_shopping_list_item

Buy item (decrements quantity; removes at zero)

Parameters2

id	string	required	The ID of the shopping list item to buy, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.
quantityToBuy	integer	optional	How many units to mark as bought. Defaults to 1. Minimum: 1, maximum 9999. If this meets or exceeds the item's remaining quantity, the item is fully bought and removed from the active list; otherwise its quantity is reduced by this amount.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the shopping list item to buy, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.",
      "examples": [
        "0189c8d4f2b1712a9e4d6c9a1b2e3f4a"
      ]
    },
    "quantityToBuy": {
      "type": "integer",
      "description": "How many units to mark as bought. Defaults to 1. Minimum: 1, maximum 9999. If this meets or exceeds the item's remaining quantity, the item is fully bought and removed from the active list; otherwise its quantity is reduced by this amount.",
      "examples": [
        1
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0189c8d4f2b1712a9e4d6c9a1b2e3f4a",
      "quantityToBuy": 1
    }
  ]
}

get_house_review

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "examples": [
    {}
  ]
}

defer_recommendation

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

Parameters1

recommendationId

string

required

Id of a pending recommendation, taken from the id field of an item returned by get_house_review.

Raw schema

{
  "type": "object",
  "properties": {
    "recommendationId": {
      "type": "string",
      "description": "Id of a pending recommendation, taken from the id field of an item returned by get_house_review.",
      "examples": [
        "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
      ]
    }
  },
  "required": [
    "recommendationId"
  ],
  "examples": [
    {
      "recommendationId": "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
    }
  ]
}

skip_recommendation

Skip: permanently suppress a House Review recommendation

Parameters1

recommendationId

string

required

Id of a pending recommendation, taken from the id field of an item returned by get_house_review.

Raw schema

{
  "type": "object",
  "properties": {
    "recommendationId": {
      "type": "string",
      "description": "Id of a pending recommendation, taken from the id field of an item returned by get_house_review.",
      "examples": [
        "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
      ]
    }
  },
  "required": [
    "recommendationId"
  ],
  "examples": [
    {
      "recommendationId": "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
    }
  ]
}

store_memory

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.

Parameters4

type	string	required	Author of the memory. 'user' for things the user has stated; 'system' for stable insights you derived yourself.
name	string	required	Short kebab-case slug, e.g. 'preferred-cleaning-day'. Max 80 chars.
description	string	required	Single-line summary used to decide relevance later. Max 200 chars.
content	string	required	Free-text body. Max 8000 chars.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "system",
        "user"
      ],
      "description": "Author of the memory. 'user' for things the user has stated; 'system' for stable insights you derived yourself.",
      "examples": [
        "user"
      ]
    },
    "name": {
      "type": "string",
      "description": "Short kebab-case slug, e.g. 'preferred-cleaning-day'. Max 80 chars.",
      "examples": [
        "preferred-cleaning-day"
      ]
    },
    "description": {
      "type": "string",
      "description": "Single-line summary used to decide relevance later. Max 200 chars.",
      "examples": [
        "User prefers the house cleaned on Saturday mornings"
      ]
    },
    "content": {
      "type": "string",
      "description": "Free-text body. Max 8000 chars.",
      "examples": [
        "The user said on 2026-07-10 they'd rather have the house cleaned Saturday mornings instead of Friday evenings, because they work late on Fridays."
      ]
    }
  },
  "required": [
    "type",
    "name",
    "description",
    "content"
  ],
  "examples": [
    {
      "type": "user",
      "name": "preferred-cleaning-day",
      "description": "User prefers the house cleaned on Saturday mornings",
      "content": "The user said they'd rather have the house cleaned Saturday mornings instead of Friday evenings, because they work late on Fridays."
    }
  ]
}

update_memory

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

Parameters4

id	string	required	Id from a prior recall_memory result.
name	string	optional	Replacement kebab-case slug. Omit to leave unchanged.
description	string	optional	Replacement single-line summary. Omit to leave unchanged.
content	string	optional	Replacement body. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id from a prior recall_memory result.",
      "examples": [
        "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
      ]
    },
    "name": {
      "type": "string",
      "description": "Replacement kebab-case slug. Omit to leave unchanged.",
      "examples": [
        "preferred-cleaning-day"
      ]
    },
    "description": {
      "type": "string",
      "description": "Replacement single-line summary. Omit to leave unchanged.",
      "examples": [
        "User now prefers the house cleaned on Sunday mornings"
      ]
    },
    "content": {
      "type": "string",
      "description": "Replacement body. Omit to leave unchanged.",
      "examples": [
        "Updated 2026-07-14: the user now prefers Sunday mornings instead of Saturday mornings for cleaning."
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0195e3c1a2b34c5d6e7f8091a2b3c4d5",
      "description": "User now prefers the house cleaned on Sunday mornings",
      "content": "Updated 2026-07-14: the user now prefers Sunday mornings instead of Saturday mornings for cleaning."
    }
  ]
}

forget_memory

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

Parameters1

string

required

Id from a prior recall_memory result.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id from a prior recall_memory result.",
      "examples": [
        "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0195e3c1a2b34c5d6e7f8091a2b3c4d5"
    }
  ]
}

recall_memory

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.

Parameters3

type	string	optional	Optional filter: 'system' for memories you (the agent) wrote, 'user' for memories the user stated. Omit to return both.
limit	integer	optional	Max number of memories to return in this page. 1-100, default 20.
cursor	string	optional	Pagination cursor: pass back the nextCursor value from a prior recall_memory response to fetch the next page. Omit to start from the first page.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "system",
        "user"
      ],
      "description": "Optional filter: 'system' for memories you (the agent) wrote, 'user' for memories the user stated. Omit to return both.",
      "examples": [
        "user"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "Max number of memories to return in this page. 1-100, default 20.",
      "examples": [
        20
      ]
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor: pass back the nextCursor value from a prior recall_memory response to fetch the next page. Omit to start from the first page.",
      "examples": [
        "eyJQSyI6IkhvdXNlaG9sZCMxMjM0In0="
      ]
    }
  },
  "examples": [
    {
      "type": "user",
      "limit": 20
    }
  ]
}

create_meal_plan

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.

Parameters7

date	string	required	Date of the planned meal (format: YYYY-MM-DD). Must be from today up to four weeks ahead.
mealType	string	required	Which meal slot of the day this entry occupies
recipeId	string	optional	ID of an existing recipe (from list_recipes or list_global_recipes)
recipeSource	string	optional	Set 'global' when recipeId refers to a Discover/global recipe (from list_global_recipes); defaults to 'household'
name	string	optional	Custom meal name when no recipe is linked
notes	string	optional	Optional free-text notes about the planned meal
servings	integer	optional	Number of servings for the planned meal. Between 1 and 100

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date of the planned meal (format: YYYY-MM-DD). Must be from today up to four weeks ahead.",
      "examples": [
        "2026-07-16"
      ]
    },
    "mealType": {
      "type": "string",
      "enum": [
        "breakfast",
        "lunch",
        "dinner",
        "snack"
      ],
      "description": "Which meal slot of the day this entry occupies",
      "examples": [
        "dinner"
      ]
    },
    "recipeId": {
      "type": "string",
      "description": "ID of an existing recipe (from list_recipes or list_global_recipes)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    },
    "recipeSource": {
      "type": "string",
      "enum": [
        "household",
        "global"
      ],
      "description": "Set 'global' when recipeId refers to a Discover/global recipe (from list_global_recipes); defaults to 'household'",
      "examples": [
        "household"
      ]
    },
    "name": {
      "type": "string",
      "description": "Custom meal name when no recipe is linked"
    },
    "notes": {
      "type": "string",
      "description": "Optional free-text notes about the planned meal"
    },
    "servings": {
      "type": "integer",
      "description": "Number of servings for the planned meal. Between 1 and 100",
      "examples": [
        4
      ]
    }
  },
  "required": [
    "date",
    "mealType"
  ],
  "examples": [
    {
      "date": "2026-07-16",
      "mealType": "dinner",
      "recipeId": "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f",
      "servings": 4
    }
  ]
}

update_meal_plan

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.

Parameters8

id	string	required	ID of the meal plan entry to update (from list_meal_plans)
date	string	optional	Date of the planned meal (format: YYYY-MM-DD). Must be from today up to four weeks ahead. Omit to leave unchanged.
mealType	string	optional	Which meal slot of the day this entry occupies. Omit to leave unchanged.
recipeId	string	optional	ID of an existing recipe (from list_recipes or list_global_recipes)
recipeSource	string	optional	Set 'global' when recipeId refers to a Discover/global recipe (from list_global_recipes); defaults to 'household'
name	string	optional	Custom meal name when no recipe is linked
notes	string	optional	Optional free-text notes about the planned meal. Omit to leave unchanged.
servings	integer	optional	Number of servings for the planned meal. Between 1 and 100. Omit to leave unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the meal plan entry to update (from list_meal_plans)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    },
    "date": {
      "type": "string",
      "description": "Date of the planned meal (format: YYYY-MM-DD). Must be from today up to four weeks ahead. Omit to leave unchanged.",
      "examples": [
        "2026-07-16"
      ]
    },
    "mealType": {
      "type": "string",
      "enum": [
        "breakfast",
        "lunch",
        "dinner",
        "snack"
      ],
      "description": "Which meal slot of the day this entry occupies. Omit to leave unchanged.",
      "examples": [
        "dinner"
      ]
    },
    "recipeId": {
      "type": "string",
      "description": "ID of an existing recipe (from list_recipes or list_global_recipes)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    },
    "recipeSource": {
      "type": "string",
      "enum": [
        "household",
        "global"
      ],
      "description": "Set 'global' when recipeId refers to a Discover/global recipe (from list_global_recipes); defaults to 'household'",
      "examples": [
        "household"
      ]
    },
    "name": {
      "type": "string",
      "description": "Custom meal name when no recipe is linked"
    },
    "notes": {
      "type": "string",
      "description": "Optional free-text notes about the planned meal. Omit to leave unchanged."
    },
    "servings": {
      "type": "integer",
      "description": "Number of servings for the planned meal. Between 1 and 100. Omit to leave unchanged.",
      "examples": [
        4
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f",
      "servings": 6
    }
  ]
}

delete_meal_plan

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.

Parameters1

string

required

ID of the meal plan entry to delete (from list_meal_plans)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the meal plan entry to delete (from list_meal_plans)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
    }
  ]
}

list_meal_plans

List meal plans in the household with an optional date range

Parameters2

from	string	optional	Inclusive date range start (format: YYYY-MM-DD). Omit for an open-ended start.
to	string	optional	Inclusive date range end (format: YYYY-MM-DD). Omit for an open-ended end.

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Inclusive date range start (format: YYYY-MM-DD). Omit for an open-ended start.",
      "examples": [
        "2026-07-14"
      ]
    },
    "to": {
      "type": "string",
      "description": "Inclusive date range end (format: YYYY-MM-DD). Omit for an open-ended end.",
      "examples": [
        "2026-07-21"
      ]
    }
  },
  "required": [],
  "examples": [
    {
      "from": "2026-07-14",
      "to": "2026-07-21"
    }
  ]
}

create_recipe

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.

Parameters5

name	string	required	Recipe name/title
url	string	optional	Optional source URL the recipe was found at (e.g. a link to a blog or recipe site)
instructions	string	optional	Optional free-text cooking instructions/method
servings	integer	optional	Number of servings the recipe yields. Minimum: 1
ingredients	array	optional	Optional list of ingredients required for the recipe

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Recipe name/title",
      "examples": [
        "Chicken Tikka Masala"
      ]
    },
    "url": {
      "type": "string",
      "description": "Optional source URL the recipe was found at (e.g. a link to a blog or recipe site)",
      "examples": [
        "https://example.com/recipes/chicken-tikka-masala"
      ]
    },
    "instructions": {
      "type": "string",
      "description": "Optional free-text cooking instructions/method"
    },
    "servings": {
      "type": "integer",
      "description": "Number of servings the recipe yields. Minimum: 1",
      "examples": [
        4
      ]
    },
    "ingredients": {
      "type": "array",
      "description": "Optional list of ingredients required for the recipe",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Ingredient name",
            "examples": [
              "chicken breast"
            ]
          },
          "quantity": {
            "type": "integer",
            "description": "Whole-number quantity of the ingredient (no fractional/unit support). Minimum: 1",
            "examples": [
              2
            ]
          }
        },
        "required": [
          "name",
          "quantity"
        ]
      }
    }
  },
  "required": [
    "name"
  ],
  "examples": [
    {
      "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
        }
      ]
    }
  ]
}

update_recipe

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.

Parameters6

id	string	required	ID of the recipe to update (from list_recipes)
name	string	optional	Recipe name/title. Omit to leave unchanged.
url	string	optional	Source URL the recipe was found at. Omit to leave unchanged.
instructions	string	optional	Free-text cooking instructions/method. Omit to leave unchanged.
servings	integer	optional	Number of servings the recipe yields. Minimum: 1. Omit to leave unchanged.
ingredients	array	optional	List of ingredients required for the recipe. Providing this replaces the entire existing ingredient list rather than merging with it. Omit to leave the ingredients unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the recipe to update (from list_recipes)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    },
    "name": {
      "type": "string",
      "description": "Recipe name/title. Omit to leave unchanged.",
      "examples": [
        "Chicken Tikka Masala"
      ]
    },
    "url": {
      "type": "string",
      "description": "Source URL the recipe was found at. Omit to leave unchanged.",
      "examples": [
        "https://example.com/recipes/chicken-tikka-masala"
      ]
    },
    "instructions": {
      "type": "string",
      "description": "Free-text cooking instructions/method. Omit to leave unchanged."
    },
    "servings": {
      "type": "integer",
      "description": "Number of servings the recipe yields. Minimum: 1. Omit to leave unchanged.",
      "examples": [
        4
      ]
    },
    "ingredients": {
      "type": "array",
      "description": "List of ingredients required for the recipe. Providing this replaces the entire existing ingredient list rather than merging with it. Omit to leave the ingredients unchanged.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Ingredient name",
            "examples": [
              "chicken breast"
            ]
          },
          "quantity": {
            "type": "integer",
            "description": "Whole-number quantity of the ingredient (no fractional/unit support). Minimum: 1",
            "examples": [
              2
            ]
          }
        },
        "required": [
          "name",
          "quantity"
        ]
      }
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f",
      "servings": 6
    }
  ]
}

delete_recipe

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.

Parameters1

string

required

ID of the recipe to delete (from list_recipes)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the recipe to delete (from list_recipes)",
      "examples": [
        "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "8f14e45f-ceea-467e-8a2f-1a2b3c4d5e6f"
    }
  ]
}

list_recipes

List all recipes in the household

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "examples": [
    {}
  ]
}

list_global_recipes

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "examples": [
    {}
  ]
}

batch_add_shopping_list_items

Add multiple items to the shopping list at once

Parameters1

items

array

required

List of items to add to the shopping list in a single call. Up to 25 items per call.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the item to add, e.g. 'Milk' or 'Paper towels'. Maximum 200 characters. Items are deduplicated within the batch by name (summing quantities) and merged into any matching unbought item already on the list.",
            "examples": [
              "Milk"
            ]
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "description": "How many of the item to add. Minimum 1, maximum 9999 (summed quantities are capped at 9999 when deduplicated or merged with an existing item).",
            "examples": [
              2
            ]
          }
        },
        "required": [
          "name",
          "quantity"
        ]
      },
      "maxItems": 25,
      "description": "List of items to add to the shopping list in a single call. Up to 25 items per call."
    }
  },
  "required": [
    "items"
  ],
  "examples": [
    {
      "items": [
        {
          "name": "Milk",
          "quantity": 2
        },
        {
          "name": "Eggs",
          "quantity": 1
        }
      ]
    }
  ]
}

update_shopping_list_item

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.

Parameters4

id	string	required	The ID of the shopping list item to update, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.
name	string	optional	New name for the item. Maximum 200 characters. Omit to leave the current name unchanged.
quantity	integer	optional	New quantity for the item, replacing (not adding to) the current quantity. Minimum 1, maximum 9999. Omit to leave the current quantity unchanged.
category	string	optional	New store-aisle category for the item, overriding any auto-assigned category. Omit to leave the current category unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the shopping list item to update, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.",
      "examples": [
        "0189c8d4f2b1712a9e4d6c9a1b2e3f4a"
      ]
    },
    "name": {
      "type": "string",
      "description": "New name for the item. Maximum 200 characters. Omit to leave the current name unchanged.",
      "examples": [
        "Whole milk"
      ]
    },
    "quantity": {
      "type": "integer",
      "description": "New quantity for the item, replacing (not adding to) the current quantity. Minimum 1, maximum 9999. Omit to leave the current quantity unchanged.",
      "examples": [
        3
      ]
    },
    "category": {
      "type": "string",
      "enum": [
        "FruitAndVegetables",
        "Bakery",
        "DeliAndPreparedFoods",
        "MeatAndSeafood",
        "DairyAndEggs",
        "Frozen",
        "PantryAndDryGoods",
        "SnacksAndConfectionery",
        "Beverages",
        "HouseholdAndCleaning",
        "HealthAndPersonalCare",
        "BabyAndKids",
        "PetSupplies",
        "Online",
        "Other"
      ],
      "description": "New store-aisle category for the item, overriding any auto-assigned category. Omit to leave the current category unchanged.",
      "examples": [
        "DairyAndEggs"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0189c8d4f2b1712a9e4d6c9a1b2e3f4a",
      "quantity": 3,
      "category": "DairyAndEggs"
    }
  ]
}

remove_shopping_list_item

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.

Parameters1

string

required

The ID of the shopping list item to remove, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the shopping list item to remove, as returned by add_shopping_list_item, batch_add_shopping_list_items, or list_shopping_list_items.",
      "examples": [
        "0189c8d4f2b1712a9e4d6c9a1b2e3f4a"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0189c8d4f2b1712a9e4d6c9a1b2e3f4a"
    }
  ]
}

create_recurring_calendar_event

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

Parameters12

title	string	required	Event title/summary applied to every generated instance. Required, up to 200 characters.
description	string	optional	Longer free-text description applied to every generated instance. Up to 2000 characters.
location	object	optional	Location applied to every generated instance. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).
startTime	string	optional	Time of day each instance starts, in HH:mm:ss format (local to timezone). Omit for an event with no fixed time.
duration	string	optional	Length of each instance, in ISO 8601 duration format.
isAllDay	boolean	optional	True if generated instances are all-day events with no specific start/end time; false for timed instances.
notes	string	optional	Freeform notes applied to every generated instance. Up to 5000 characters.
cronExpression	string	required	Recurrence interval, NOT a cron expression despite the field name. Format is 'N Unit' where N is a positive integer and Unit is one of Day, Week, Month, Year (case-sensitive), e.g. '1 Day', '2 Week', '1 Month', '1 Year'. Instances recur every N of the given unit starting from startDate.
startDate	string	optional	Anchor date the recurrence is calculated from, YYYY-MM-DD format. The first instance falls on this date (subject to startTime/timezone); later instances are startDate plus multiples of the cronExpression interval.
endDate	string	optional	Last date on which instances may occur, YYYY-MM-DD format. Omit for no end date (bounded only by maxOccurrences, if set).
maxOccurrences	integer	optional	Maximum number of instances to generate before recurrence stops. Omit for unlimited (bounded only by endDate, if set).
timezone	string \| null	optional	IANA timezone id (e.g. 'Europe/London') that startTime is in. Each generated occurrence's UTC instant respects this zone's DST.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Event title/summary applied to every generated instance. Required, up to 200 characters.",
      "examples": [
        "Weekly team standup"
      ]
    },
    "description": {
      "type": "string",
      "description": "Longer free-text description applied to every generated instance. Up to 2000 characters."
    },
    "location": {
      "type": "object",
      "description": "Location applied to every generated instance. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).",
      "properties": {
        "$type": {
          "type": "string",
          "enum": [
            "Address",
            "OnlineLocation"
          ],
          "description": "Location type discriminator"
        },
        "line1": {
          "type": "string",
          "description": "First line of the street address (Address type). At least one of line1-3/postalCode is required when $type is 'Address'.",
          "examples": [
            "221B Baker Street"
          ]
        },
        "line2": {
          "type": "string",
          "description": "Second line of the street address (Address type), e.g. building or suite."
        },
        "line3": {
          "type": "string",
          "description": "Third line of the street address (Address type)."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code (Address type). Up to 20 characters.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code for the address (Address type).",
          "examples": [
            "GB"
          ]
        },
        "url": {
          "type": "string",
          "description": "URL for online locations (OnlineLocation type). Must be an absolute http/https URL.",
          "examples": [
            "https://meet.google.com/abc-defg-hij"
          ]
        },
        "notes": {
          "type": "string",
          "description": "Notes about the location, e.g. parking instructions or a meeting passcode. Up to 500 characters for OnlineLocation."
        }
      },
      "required": [
        "$type"
      ]
    },
    "startTime": {
      "type": "string",
      "description": "Time of day each instance starts, in HH:mm:ss format (local to timezone). Omit for an event with no fixed time.",
      "examples": [
        "09:00:00"
      ]
    },
    "duration": {
      "type": "string",
      "description": "Length of each instance, in ISO 8601 duration format.",
      "examples": [
        "PT30M"
      ]
    },
    "isAllDay": {
      "type": "boolean",
      "description": "True if generated instances are all-day events with no specific start/end time; false for timed instances.",
      "examples": [
        false
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes applied to every generated instance. Up to 5000 characters."
    },
    "cronExpression": {
      "type": "string",
      "description": "Recurrence interval, NOT a cron expression despite the field name. Format is 'N Unit' where N is a positive integer and Unit is one of Day, Week, Month, Year (case-sensitive), e.g. '1 Day', '2 Week', '1 Month', '1 Year'. Instances recur every N of the given unit starting from startDate.",
      "examples": [
        "1 Week"
      ]
    },
    "startDate": {
      "type": "string",
      "description": "Anchor date the recurrence is calculated from, YYYY-MM-DD format. The first instance falls on this date (subject to startTime/timezone); later instances are startDate plus multiples of the cronExpression interval.",
      "examples": [
        "2026-08-03"
      ]
    },
    "endDate": {
      "type": "string",
      "description": "Last date on which instances may occur, YYYY-MM-DD format. Omit for no end date (bounded only by maxOccurrences, if set).",
      "examples": [
        "2026-12-31"
      ]
    },
    "maxOccurrences": {
      "type": "integer",
      "description": "Maximum number of instances to generate before recurrence stops. Omit for unlimited (bounded only by endDate, if set).",
      "examples": [
        20
      ]
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone id (e.g. 'Europe/London') that startTime is in. Each generated occurrence's UTC instant respects this zone's DST.",
      "examples": [
        "Europe/London"
      ]
    }
  },
  "required": [
    "title",
    "cronExpression"
  ],
  "examples": [
    {
      "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"
    }
  ]
}

update_recurring_calendar_event

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

Parameters13

id	string	required	Id of the recurring calendar event (template) to update.
title	string	optional	New event title/summary. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 200 characters.
description	string	optional	New longer free-text description. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 2000 characters.
location	object	optional	New location, replacing the existing one entirely. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).
startTime	string	optional	New time of day each instance starts, in HH:mm:ss format (local to timezone). Omit to leave unchanged. Changing this deletes and regenerates future instances.
duration	string	optional	New length of each instance, in ISO 8601 duration format. Omit to leave unchanged. Changing this deletes and regenerates future instances.
isAllDay	boolean	optional	True if generated instances are all-day events; false for timed instances. Omit to leave unchanged. Changing this deletes and regenerates future instances.
notes	string	optional	New freeform notes. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 5000 characters.
cronExpression	string	optional	New recurrence interval, NOT a cron expression despite the field name. Format is 'N Unit' where N is a positive integer and Unit is one of Day, Week, Month, Year (case-sensitive), e.g. '1 Day', '2 Week', '1 Month', '1 Year'. Omit to leave unchanged. Changing this deletes and regenerates future instances.
startDate	string	optional	PATCH-style date field: omit or send null to leave the stored start date unchanged, send an empty string to clear it, or send 'YYYY-MM-DD' to set a new anchor date. Changing this deletes and regenerates future instances.
endDate	string	optional	PATCH-style date field: omit or send null to leave the stored end date unchanged, send an empty string to clear it (recurrence becomes unbounded by date), or send 'YYYY-MM-DD' to set a new last occurrence date. Changing this deletes and regenerates future instances.
maxOccurrences	integer	optional	New maximum number of instances to generate. Omit to leave unchanged. Changing this deletes and regenerates future instances.
timezone	string \| null	optional	IANA timezone id (e.g. 'Europe/London') that startTime is in. Omit to leave unchanged; null resets to UTC. Changing this regenerates instances.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id of the recurring calendar event (template) to update.",
      "examples": [
        "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
      ]
    },
    "title": {
      "type": "string",
      "description": "New event title/summary. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 200 characters."
    },
    "description": {
      "type": "string",
      "description": "New longer free-text description. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 2000 characters."
    },
    "location": {
      "type": "object",
      "description": "New location, replacing the existing one entirely. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Set $type to 'Address' for physical (with line1-3, postalCode, countryCode) or 'OnlineLocation' for virtual (with url, notes).",
      "properties": {
        "$type": {
          "type": "string",
          "enum": [
            "Address",
            "OnlineLocation"
          ],
          "description": "Location type discriminator"
        },
        "line1": {
          "type": "string",
          "description": "First line of the street address (Address type). At least one of line1-3/postalCode is required when $type is 'Address'.",
          "examples": [
            "221B Baker Street"
          ]
        },
        "line2": {
          "type": "string",
          "description": "Second line of the street address (Address type), e.g. building or suite."
        },
        "line3": {
          "type": "string",
          "description": "Third line of the street address (Address type)."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal or ZIP code (Address type). Up to 20 characters.",
          "examples": [
            "NW1 6XE"
          ]
        },
        "countryCode": {
          "type": "string",
          "description": "Country code for the address (Address type).",
          "examples": [
            "GB"
          ]
        },
        "url": {
          "type": "string",
          "description": "URL for online locations (OnlineLocation type). Must be an absolute http/https URL."
        },
        "notes": {
          "type": "string",
          "description": "Notes about the location, e.g. parking instructions or a meeting passcode. Up to 500 characters for OnlineLocation."
        }
      },
      "required": [
        "$type"
      ]
    },
    "startTime": {
      "type": "string",
      "description": "New time of day each instance starts, in HH:mm:ss format (local to timezone). Omit to leave unchanged. Changing this deletes and regenerates future instances.",
      "examples": [
        "09:00:00"
      ]
    },
    "duration": {
      "type": "string",
      "description": "New length of each instance, in ISO 8601 duration format. Omit to leave unchanged. Changing this deletes and regenerates future instances.",
      "examples": [
        "PT30M"
      ]
    },
    "isAllDay": {
      "type": "boolean",
      "description": "True if generated instances are all-day events; false for timed instances. Omit to leave unchanged. Changing this deletes and regenerates future instances."
    },
    "notes": {
      "type": "string",
      "description": "New freeform notes. Omit to leave unchanged. Patching this alone updates existing generated instances in place rather than regenerating them. Up to 5000 characters."
    },
    "cronExpression": {
      "type": "string",
      "description": "New recurrence interval, NOT a cron expression despite the field name. Format is 'N Unit' where N is a positive integer and Unit is one of Day, Week, Month, Year (case-sensitive), e.g. '1 Day', '2 Week', '1 Month', '1 Year'. Omit to leave unchanged. Changing this deletes and regenerates future instances.",
      "examples": [
        "2 Week"
      ]
    },
    "startDate": {
      "type": "string",
      "description": "PATCH-style date field: omit or send null to leave the stored start date unchanged, send an empty string to clear it, or send 'YYYY-MM-DD' to set a new anchor date. Changing this deletes and regenerates future instances.",
      "examples": [
        "2026-08-03"
      ]
    },
    "endDate": {
      "type": "string",
      "description": "PATCH-style date field: omit or send null to leave the stored end date unchanged, send an empty string to clear it (recurrence becomes unbounded by date), or send 'YYYY-MM-DD' to set a new last occurrence date. Changing this deletes and regenerates future instances.",
      "examples": [
        "2027-01-31"
      ]
    },
    "maxOccurrences": {
      "type": "integer",
      "description": "New maximum number of instances to generate. Omit to leave unchanged. Changing this deletes and regenerates future instances.",
      "examples": [
        20
      ]
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone id (e.g. 'Europe/London') that startTime is in. Omit to leave unchanged; null resets to UTC. Changing this regenerates instances.",
      "examples": [
        "Europe/London"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198f3a1b2c34d5e6f7089ab1c2d3e4f",
      "cronExpression": "2 Week",
      "endDate": "2027-01-31"
    }
  ]
}

delete_recurring_calendar_event

Delete a recurring calendar event and all its future instances.

Parameters1

string

required

Id of the recurring calendar event (template) to delete.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id of the recurring calendar event (template) to delete.",
      "examples": [
        "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "0198f3a1b2c34d5e6f7089ab1c2d3e4f"
    }
  ]
}

create_recurring_task

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

Parameters8

title	string	required	The recurring task's title. Used as the title for every generated task instance.
notes	string	optional	Freeform notes copied to every generated task instance.
preparationDays	integer	optional	Number of days before each occurrence's due date to set that instance's preparation date. Clamped to today if the computed date would be in the past.
cronExpression	string	required	Recurrence frequency expression in the format 'N Unit', e.g. '2 Week' for every two weeks. Unit must be exactly Day, Week, Month, or Year (case-sensitive). Despite the parameter name, this is not cron syntax.
startDate	string	optional	The date the schedule starts generating instances from, in YYYY-MM-DD format. Defaults to today if omitted.
endDate	string	optional	The last date instances are generated through (inclusive), in YYYY-MM-DD format. Omit for an open-ended schedule.
maxOccurrences	integer	optional	Maximum number of task instances to generate in total. Generation stops once this many instances have been created, even if endDate has not been reached.
assigneeRotation	array	optional	Ordered list of household member IDs to round-robin through, one per generated instance. Entries that are no longer valid house members are skipped and that instance is left unassigned.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The recurring task's title. Used as the title for every generated task instance.",
      "examples": [
        "Take out the recycling"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Freeform notes copied to every generated task instance."
    },
    "preparationDays": {
      "type": "integer",
      "description": "Number of days before each occurrence's due date to set that instance's preparation date. Clamped to today if the computed date would be in the past.",
      "examples": [
        1
      ]
    },
    "cronExpression": {
      "type": "string",
      "description": "Recurrence frequency expression in the format 'N Unit', e.g. '2 Week' for every two weeks. Unit must be exactly Day, Week, Month, or Year (case-sensitive). Despite the parameter name, this is not cron syntax.",
      "examples": [
        "2 Week"
      ]
    },
    "startDate": {
      "type": "string",
      "description": "The date the schedule starts generating instances from, in YYYY-MM-DD format. Defaults to today if omitted.",
      "examples": [
        "2026-08-01"
      ]
    },
    "endDate": {
      "type": "string",
      "description": "The last date instances are generated through (inclusive), in YYYY-MM-DD format. Omit for an open-ended schedule.",
      "examples": [
        "2026-12-31"
      ]
    },
    "maxOccurrences": {
      "type": "integer",
      "description": "Maximum number of task instances to generate in total. Generation stops once this many instances have been created, even if endDate has not been reached.",
      "examples": [
        26
      ]
    },
    "assigneeRotation": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A household member ID (from list_house_members) taking a turn in the rotation.",
        "examples": [
          "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
        ]
      },
      "description": "Ordered list of household member IDs to round-robin through, one per generated instance. Entries that are no longer valid house members are skipped and that instance is left unassigned."
    }
  },
  "required": [
    "title",
    "cronExpression"
  ],
  "examples": [
    {
      "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"
      ]
    }
  ]
}

update_recurring_task

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

Parameters9

id	string	required	The recurring task's ID, as returned by create_recurring_task or list_recurring_tasks.
title	string	optional	New title for the template. Existing uncompleted generated instances are updated to match; completed ones keep their original title. Omit to leave unchanged.
notes	string	optional	New notes for the template, copied to existing uncompleted generated instances. Omit to leave unchanged.
preparationDays	integer	optional	Number of days before each occurrence's due date to set that instance's preparation date. Only affects instances generated after this change; existing uncompleted instances keep their original preparation date unless a frequency, start date, end date, or max-occurrences change also triggers regeneration.
cronExpression	string	optional	New recurrence frequency expression in the format 'N Unit', e.g. '2 Week' for every two weeks. Unit must be exactly Day, Week, Month, or Year (case-sensitive). Despite the parameter name, this is not cron syntax. Changing this deletes uncompleted future instances and regenerates them from the new schedule.
startDate	string	optional	New start date for the schedule, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it. Changing this regenerates future uncompleted instances.
endDate	string	optional	New end date for the schedule (inclusive), in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string for an open-ended schedule. Changing this regenerates future uncompleted instances.
maxOccurrences	integer	optional	New maximum total number of instances to generate. Changing this regenerates future uncompleted instances.
assigneeRotation	array	optional	New ordered list of household member IDs to round-robin through, replacing the existing rotation entirely. Applies to instances generated after this change; already-created instances are unaffected. Omit to leave the rotation unchanged.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The recurring task's ID, as returned by create_recurring_task or list_recurring_tasks.",
      "examples": [
        "5c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f"
      ]
    },
    "title": {
      "type": "string",
      "description": "New title for the template. Existing uncompleted generated instances are updated to match; completed ones keep their original title. Omit to leave unchanged."
    },
    "notes": {
      "type": "string",
      "description": "New notes for the template, copied to existing uncompleted generated instances. Omit to leave unchanged."
    },
    "preparationDays": {
      "type": "integer",
      "description": "Number of days before each occurrence's due date to set that instance's preparation date. Only affects instances generated after this change; existing uncompleted instances keep their original preparation date unless a frequency, start date, end date, or max-occurrences change also triggers regeneration.",
      "examples": [
        1
      ]
    },
    "cronExpression": {
      "type": "string",
      "description": "New recurrence frequency expression in the format 'N Unit', e.g. '2 Week' for every two weeks. Unit must be exactly Day, Week, Month, or Year (case-sensitive). Despite the parameter name, this is not cron syntax. Changing this deletes uncompleted future instances and regenerates them from the new schedule.",
      "examples": [
        "2 Week"
      ]
    },
    "startDate": {
      "type": "string",
      "description": "New start date for the schedule, in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string to clear it. Changing this regenerates future uncompleted instances.",
      "examples": [
        "2026-08-01"
      ]
    },
    "endDate": {
      "type": "string",
      "description": "New end date for the schedule (inclusive), in YYYY-MM-DD format. Omit to leave unchanged, or send an empty string for an open-ended schedule. Changing this regenerates future uncompleted instances.",
      "examples": [
        "2026-12-31"
      ]
    },
    "maxOccurrences": {
      "type": "integer",
      "description": "New maximum total number of instances to generate. Changing this regenerates future uncompleted instances.",
      "examples": [
        26
      ]
    },
    "assigneeRotation": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A household member ID (from list_house_members) taking a turn in the rotation.",
        "examples": [
          "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
        ]
      },
      "description": "New ordered list of household member IDs to round-robin through, replacing the existing rotation entirely. Applies to instances generated after this change; already-created instances are unaffected. Omit to leave the rotation unchanged."
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "5c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f",
      "title": "Take out the recycling",
      "cronExpression": "2 Week",
      "assigneeRotation": [
        "7f3a9c2e1b4d8f6a0c5e3b7d9a1f4c6e"
      ]
    }
  ]
}

delete_recurring_task

Delete a recurring task and all its uncompleted future instances.

Parameters1

string

required

The recurring task's ID, as returned by create_recurring_task or list_recurring_tasks.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The recurring task's ID, as returned by create_recurring_task or list_recurring_tasks.",
      "examples": [
        "5c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f"
      ]
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "5c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f"
    }
  ]
}

Install

Tools (68)

create_contactupdate_contactdelete_contactlist_contactscreate_applianceupdate_appliancedelete_appliancelist_appliances

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.onehaus.app

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "haus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.onehaus.app"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: app.onehaus/haus

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_contact

update_contact

delete_contact

list_contacts

create_appliance

update_appliance

delete_appliance

list_appliances

create_calendar_event

update_calendar_event

delete_calendar_event

list_calendar_events

create_document

update_document

delete_document

list_documents

create_pet

update_pet

delete_pet

list_pets

create_subscription

update_subscription

delete_subscription

list_subscriptions

create_vehicle

update_vehicle

delete_vehicle

list_vehicles

create_task

update_task

delete_task

complete_task

uncomplete_task

assign_task

list_tasks

get_weather_forecast

get_house

list_house_members

list_houses

get_profile

list_shopping_list_items

add_shopping_list_item

buy_shopping_list_item

get_house_review

defer_recommendation

skip_recommendation

store_memory

update_memory

forget_memory

recall_memory

create_meal_plan

update_meal_plan

delete_meal_plan

list_meal_plans

create_recipe

update_recipe

delete_recipe

list_recipes

list_global_recipes

batch_add_shopping_list_items

update_shopping_list_item

remove_shopping_list_item

create_recurring_calendar_event

update_recurring_calendar_event

delete_recurring_calendar_event

create_recurring_task

update_recurring_task

delete_recurring_task

Install

Remote endpoint

Related servers