quok-mcp - MCP tools

server_inforead-only

Server info

Returns Quok MCP server status, version, and the family/member this connection is bound to. Use to verify connectivity and which environment (staging vs prod) you are hitting.

No parameters.

list_family_eventsread-only

List family events

List this Quok family's shared calendar events (appointments, bills, chores, birthdays, etc.) within a time window. Recurring events are expanded: one entry per occurrence falling inside the window, each with its own `occurrenceStart` (the series may have started long before `from`), plus `seriesEventId` and `isException`. Use `occurrenceStart`, not `startsAt`, to date an occurrence. Returns only events the connected member can see. Includes both confirmed and `proposed` events (the latter staged by ingestion, pending review) - pass `status` to filter to one. Approve a proposal by calling update_family_event with status `confirmed`.

get_family_eventread-only

Get family event

Fetch a single event from this Quok family's shared calendar by id, including its full details.

create_family_event

Create family event

Create an event on this Quok family's shared calendar (a typed event: appointment, bill, chore, birthday, meal, lesson, flight, hotel, etc.). Defaults to `confirmed`; pass status `proposed` to stage it for review.

update_family_eventidempotent

Update family event

Update fields on an existing event in this Quok family's shared calendar. Provide only the fields to change in "patch". Patch `status` to transition the event (e.g. confirm a proposed event, or re-propose a confirmed one).

delete_family_eventdestructiveidempotent

Delete family event

Permanently delete an event from this Quok family's shared calendar.

list_family_listsread-only

List family lists

List the family's task and shopping lists, optionally filtered by type.

list_family_itemsread-only

List family items

List the items on a specific list.

get_family_itemread-only

Get family item

Fetch a single list item (task or shopping item) by id.

list_family_tasksread-only

List family tasks

List the family's to-do items: items across all todo lists. Mirrors the app's "All tasks" view.

No parameters.

list_family_shoppingread-only

List family shopping items

List the family's shopping items (items across all shopping and groceries lists).

No parameters.

add_family_task

Add family task

Add a to-do item. Targets the given listId, or the family's default todo list when omitted.

add_family_shopping_item

Add family shopping item

Add a shopping item. Targets the given listId, or the family's default shopping list when omitted.

update_family_list_itemidempotent

Update family list item

Update fields on a Quok list item (task or shopping item). Provide only the fields to change in "patch"; set `checked` to tick/untick it, or `listId` to move it to another list.

complete_family_list_itemidempotent

Complete family list item

Tick off a list item (or untick it by passing checked=false).

delete_family_list_itemdestructiveidempotent

Delete family list item

Permanently delete a list item (task or shopping item).

create_family_list

Create family list

Create a new Quok family list (a todo, shopping, groceries, or packing list). Returns the new list including its id.

rename_family_listidempotent

Rename family list

Rename a Quok family list. Provide only the fields to change in "patch".

delete_family_listdestructiveidempotent

Delete family list

Permanently delete a Quok family list and all its items. A list that is its type's default cannot be deleted - it is where items land when no list is specified.

search_familyread-only

Search family

Full-text search across this Quok family's entities - calendar events, lists, list items (shopping/tasks), and members - ranked by relevance. Use this to find something by keyword when you don't know its id or exact location (e.g. "dentist", "milk", a person's name). Returns only entities the connected member can see. Pass `types` to restrict to certain kinds.