Référence des outils

Le serveur MCP à l’adresse https://mcp.todomino.eu/mcp expose 17 outils. Les outils en lecture seule sont annotés readOnlyHint ; les outils destructifs sont annotés destructiveHint, afin que les clients bien élevés demandent confirmation avant de les exécuter. Les IDs circulent d’un outil à l’autre : commence par list_workspaces, utilise ses ids avec list_tasks, et ainsi de suite.

Découverte (lecture seule)

list_workspaces

Aucun paramètre. Renvoie tes espaces de travail avec id, le name d’affichage, l’indicateur personal et ton role. Commence ici — tous les autres outils ont besoin d’un workspaceId issu de cette liste.

list_tasks

Paramètre	Type	Remarques
workspaceId	string	obligatoire
status	PENDING | IN_PROGRESS | DONE	filtre optionnel
listId	string	filtre optionnel
assigneeId	string	filtre optionnel (userId d’un membre)

Renvoie des tâches compactes : id, titre, statut, motif de blocage (lorsqu’elle est signalée), priorité, date d’échéance, liste, personne assignée, progression des sous-tâches ("2/5 done") et nombre de pièces jointes.

get_task

workspaceId, taskId. Le détail complet d’une tâche : description, créateur, toutes les sous-tâches avec leurs ids, et les pièces jointes avec ids, noms de fichiers, types de média et tailles.

list_lists

workspaceId. Renvoie les listes de tâches avec leurs ids et leurs noms.

list_members

workspaceId. Renvoie les membres avec userId, nom et rôle — nécessaire pour assigner des tâches.

get_attachment

workspaceId, taskId, attachmentId. Télécharge une pièce jointe et renvoie son contenu : les images comme images, les fichiers de type texte (texte, JSON, XML, CSV, …) comme texte (tronqué à 100k caractères), les autres binaires comme ressource base64. Refuse les fichiers de plus de 8 Mo.

Création et mise à jour

create_task

Paramètre	Type	Remarques
workspaceId	string	obligatoire
title	string	obligatoire
description	string	optionnel
priority	LOW | NORMAL | HIGH | CRITICAL	optionnel
dueDate	YYYY-MM-DD	optionnel
listId	string	optionnel

update_task

Mêmes champs que create_task plus taskId et assigneeId ; seuls les champs fournis changent, null efface la priorité, la date d’échéance, la liste ou la personne assignée. Annoté destructif (il écrase les valeurs existantes).

set_task_status / set_subtask_status

workspaceId, taskId (+ subtaskId), done (booléen). Réversible et idempotent.

add_subtask

workspaceId, taskId, title.

create_list

workspaceId, name. Une couleur est choisie automatiquement.

add_attachment

Paramètre	Type	Remarques
workspaceId, taskId	string	obligatoires
fileName	string	extension incluse
mediaType	string	type MIME optionnel
text	string	contenu en texte brut…
base64	string	…ou contenu binaire — exactement l’un des deux

Le contenu est dédupliqué par espace de travail (deduplicated: true dans le résultat) ; joindre deux fois le même fichier à la même tâche est refusé. Limite de 8 Mo ; compte dans le quota de stockage de l’espace de travail.

Suppression (destructif — les clients demandent d’abord confirmation)

delete_task

workspaceId, taskId. Supprime la tâche avec ses sous-tâches et ses références de pièces jointes. Irréversible.

delete_subtask

workspaceId, taskId, subtaskId.

delete_attachment

workspaceId, taskId, attachmentId. Le fichier stocké n’est supprimé que lorsqu’aucune autre tâche ne référence le même contenu.

delete_list

workspaceId, listId. Les tâches de la liste ne sont pas supprimées — elles continuent d’exister sans liste.

Non disponible pour les assistants

Supprimer des espaces de travail entiers et gérer les membres ne sont délibérément pas exposés — ces actions restent réservées aux humains dans l’application Todomino.