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. Not a personal Google Calendar. Returns only events the connected member can see.

get_family_eventread-only

Get family event

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

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.). This is the Quok household calendar, not a personal Google Calendar. Defaults to `confirmed`; pass status `proposed` to stage it for review.

update_family_event

Update family event

Update fields on an existing event in this Quok family's shared calendar (not a personal Google 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. Not a personal Google 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_item

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_list

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. The seeded default list cannot be deleted.

set_default_family_listidempotent

Set default family list

Make a list the family's default for its type, so add_family_task / add_family_shopping_item route to it when no listId is given. Clears any prior default of the same type.