Tool reference
The MCP server at https://mcp.todomino.eu/mcp exposes 17 tools. Read-only
tools are annotated readOnlyHint; destructive tools are annotated
destructiveHint, so well-behaved clients ask for confirmation before
running them. IDs flow between tools: start with list_workspaces, use its
ids with list_tasks, and so on.
Discovery (read-only)
Section titled “Discovery (read-only)”list_workspaces
Section titled “list_workspaces”No parameters. Returns your workspaces with id, display name,
personal flag, and your role. Start here — every other tool needs a
workspaceId from this list.
list_tasks
Section titled “list_tasks”| Parameter | Type | Notes |
|---|---|---|
workspaceId |
string | required |
status |
PENDING | IN_PROGRESS | DONE |
optional filter |
listId |
string | optional filter |
assigneeId |
string | optional filter (member userId) |
Returns compact tasks: id, title, status, blocked reason (when flagged),
priority, due date, list, assignee, subtask progress ("2/5 done"), and
attachment count.
get_task
Section titled “get_task”workspaceId, taskId. Full detail of one task: description, creator,
all subtasks with ids, and attachments with ids, file names, media types,
and sizes.
list_lists
Section titled “list_lists”workspaceId. Returns the task lists with ids and names.
list_members
Section titled “list_members”workspaceId. Returns members with userId, name, and role — needed for
assigning tasks.
get_attachment
Section titled “get_attachment”workspaceId, taskId, attachmentId. Downloads an attachment and
returns its content: images as images, text-like files (text, JSON, XML,
CSV, …) as text (truncated at 100k characters), other binaries as a base64
resource. Refuses files over 8 MB.
Creating and updating
Section titled “Creating and updating”create_task
Section titled “create_task”| Parameter | Type | Notes |
|---|---|---|
workspaceId |
string | required |
title |
string | required |
description |
string | optional |
priority |
LOW | NORMAL | HIGH | CRITICAL |
optional |
dueDate |
YYYY-MM-DD |
optional |
listId |
string | optional |
update_task
Section titled “update_task”Same fields as create_task plus taskId and assigneeId; only provided
fields change, null clears priority, due date, list, or assignee.
Annotated destructive (it overwrites existing values).
set_task_status / set_subtask_status
Section titled “set_task_status / set_subtask_status”workspaceId, taskId (+ subtaskId), done (boolean). Reversible and
idempotent.
add_subtask
Section titled “add_subtask”workspaceId, taskId, title.
create_list
Section titled “create_list”workspaceId, name. A color is picked automatically.
add_attachment
Section titled “add_attachment”| Parameter | Type | Notes |
|---|---|---|
workspaceId, taskId |
string | required |
fileName |
string | including extension |
mediaType |
string | optional MIME type |
text |
string | plain-text content… |
base64 |
string | …or binary content — exactly one of the two |
Content is deduplicated per workspace (deduplicated: true in the result);
attaching the same file to the same task twice is rejected. Limit 8 MB;
counts toward the workspace storage quota.
Deleting (destructive — clients confirm first)
Section titled “Deleting (destructive — clients confirm first)”delete_task
Section titled “delete_task”workspaceId, taskId. Deletes the task with subtasks and attachment
references. Cannot be undone.
delete_subtask
Section titled “delete_subtask”workspaceId, taskId, subtaskId.
delete_attachment
Section titled “delete_attachment”workspaceId, taskId, attachmentId. The stored file is deleted only
when no other task references the same content.
delete_list
Section titled “delete_list”workspaceId, listId. Tasks in the list are not deleted — they keep
existing without a list.
Not available to assistants
Section titled “Not available to assistants”Deleting whole workspaces and managing members are deliberately not exposed — those remain human actions in the Todomino app.