Superlist

Returns a single list with its tasks (most-recently-updated first, up to 100), its sublists and parent list, and delta document contents rendered as Markdown (truncated to a hard cap). When `tasks_truncated` is true, use `search` to find specific tasks within the list.

get_list

Fetches lists accessible by the user, most-recently-updated first. Returns up to 100 lists; when `truncated` is true, use the `search` tool to find specific lists by title.

get_lists

Returns the message thread of a task: the chat messages collaborators leave on it ("Leave a message…" in the apps), oldest first. These are separate from the task's notes returned by `get_task`. Deleted messages are omitted. To check back for replies, pass the newest `synced_at` you have seen as `since`; only messages created or edited after it are returned.

get_messages

Returns a single task with its details and notes (delta document contents) rendered as Markdown (truncated to a hard cap). The task's message thread is not included; use `get_messages` for that.

get_task

Returns tasks from the user's inbox, most-recently-updated first. Returns up to 100 tasks; when `truncated` is true, use the `search` tool to find specific tasks.

inbox

Moves an existing task into a different list, or to the inbox — or moves several tasks in one call. If list_uuid is omitted or null, the task is moved to the user's inbox. Provide exactly one of `task_uuid` (single task) or `moves` (several) — never both. Prefer `moves` when the user asks to move more than one task, so the whole change is applied as one operation. Cannot be used on a subtask of another task — use the Superlist client for that.

move_task

Removes a label from a task, or from several tasks in one call. Provide exactly one of `task_uuid` (with `label`) for a single task, or `labels` for several — never both. Prefer `labels` when the user asks to unlabel more than one task, so the whole change is applied as one operation.

remove_label

Restores a list that was deleted with delete_list, bringing it back with its previous content. The tasks that delete_list moved to the trash together with the list come back with it. This does NOT restore a task that was deleted in its own right, before or after the list — call restore_task for each of those. Only works while the list is in the trash — once it has been permanently deleted it cannot be recovered.

restore_list

Restores a task that was deleted with delete_task, or several in one call, bringing each back with its previous content and state. Only works while the task is in the trash — once it has been permanently deleted it cannot be recovered. Provide exactly one of `task_uuid` (single task) or `task_uuids` (several) — never both. Prefer `task_uuids` when the user asks to restore more than one task, so the whole change is applied as one operation.

restore_task

Searches the user's tasks and lists. Returns matching results with ids that can be passed to the `fetch` tool to retrieve full content.

search

Shares a list with another user, granting them access. Provide exactly one of `user_uuid` or `user_email`. The actor must already have access to the list. Plan limits on shared list count and collaborators per list are enforced.

share_list

Returns tasks due today or earlier that are assigned to you (or authored by you and unassigned), excluding completed, deleted, and archived tasks. Most-recently-updated first; returns up to 100 tasks. When `truncated` is true, use the `search` tool to find specific tasks.

today

Removes the assignee from a task. The task itself remains unchanged otherwise.

unassign_task

Removes a collaborator from a list, revoking their shared access. Provide exactly one of `user_uuid` or `user_email`. The actor must already have access to the list.

unshare_list

Updates a list. Can change the title, emoji, or body content. This is also the way to add several tasks to an existing list at once — put them in `content` as GitHub-flavoured markdown task items rather than calling `add_task` repeatedly. Editing body content replaces it wholesale — to ADD to existing content, read it first with get_list and resend it with your additions.

update_list

Updates a task, or several tasks in one call. Can change the title, due date, repetition, priority or body content. Provide exactly one of `task_uuid` (single task) or `updates` (several) — never both. Prefer `updates` when the user asks to change more than one task, so the whole change is applied as one operation. Editing body content replaces it wholesale — to ADD to existing content, read it first with get_task and resend it with your additions.

update_task