Referencia de herramientas

El servidor MCP en https://mcp.todomino.eu/mcp expone 17 herramientas. Las herramientas de solo lectura están anotadas con readOnlyHint; las destructivas están anotadas con destructiveHint, de modo que los clientes que se comportan bien piden confirmación antes de ejecutarlas. Los IDs fluyen entre herramientas: empieza con list_workspaces, usa sus ids con list_tasks, y así sucesivamente.

Descubrimiento (solo lectura)

list_workspaces

Sin parámetros. Devuelve tus espacios de trabajo con id, name para mostrar, el indicador personal y tu role. Empieza aquí — todas las demás herramientas necesitan un workspaceId de esta lista.

list_tasks

Parámetro	Tipo	Notas
workspaceId	string	obligatorio
status	PENDING | IN_PROGRESS | DONE	filtro opcional
listId	string	filtro opcional
assigneeId	string	filtro opcional (userId de un miembro)

Devuelve tareas compactas: id, título, estado, motivo del bloqueo (cuando está marcada), prioridad, fecha límite, lista, persona asignada, progreso de subtareas ("2/5 done") y número de archivos adjuntos.

get_task

workspaceId, taskId. Detalle completo de una tarea: descripción, creador, todas las subtareas con ids, y archivos adjuntos con ids, nombres de archivo, tipos de medio y tamaños.

list_lists

workspaceId. Devuelve las listas de tareas con ids y nombres.

list_members

workspaceId. Devuelve los miembros con userId, nombre y rol — necesario para asignar tareas.

get_attachment

workspaceId, taskId, attachmentId. Descarga un archivo adjunto y devuelve su contenido: las imágenes como imágenes, los archivos de tipo texto (texto, JSON, XML, CSV, …) como texto (truncado a 100k caracteres), otros binarios como un recurso base64. Rechaza archivos de más de 8 MB.

Crear y actualizar

create_task

Parámetro	Tipo	Notas
workspaceId	string	obligatorio
title	string	obligatorio
description	string	opcional
priority	LOW | NORMAL | HIGH | CRITICAL	opcional
dueDate	YYYY-MM-DD	opcional
listId	string	opcional

update_task

Los mismos campos que create_task más taskId y assigneeId; solo cambian los campos proporcionados, null borra la prioridad, la fecha límite, la lista o la persona asignada. Anotada como destructiva (sobrescribe valores existentes).

set_task_status / set_subtask_status

workspaceId, taskId (+ subtaskId), done (booleano). Reversible e idempotente.

add_subtask

workspaceId, taskId, title.

create_list

workspaceId, name. El color se elige automáticamente.

add_attachment

Parámetro	Tipo	Notas
workspaceId, taskId	string	obligatorios
fileName	string	incluida la extensión
mediaType	string	tipo MIME opcional
text	string	contenido de texto plano…
base64	string	…o contenido binario — exactamente uno de los dos

El contenido se deduplica por espacio de trabajo (deduplicated: true en el resultado); adjuntar el mismo archivo dos veces a la misma tarea se rechaza. Límite de 8 MB; cuenta para la cuota de almacenamiento del espacio de trabajo.

Eliminar (destructivo — los clientes confirman antes)

delete_task

workspaceId, taskId. Elimina la tarea con sus subtareas y referencias a archivos adjuntos. No se puede deshacer.

delete_subtask

workspaceId, taskId, subtaskId.

delete_attachment

workspaceId, taskId, attachmentId. El archivo almacenado solo se elimina cuando ninguna otra tarea referencia el mismo contenido.

delete_list

workspaceId, listId. Las tareas de la lista no se eliminan — siguen existiendo sin lista.

No disponible para asistentes

Eliminar espacios de trabajo completos y gestionar miembros no está expuesto de forma deliberada — esas siguen siendo acciones humanas en la aplicación de Todomino.