Tool-Referenz
Der MCP-Server unter https://mcp.todomino.eu/mcp stellt 17 Tools bereit.
Rein lesende Tools sind mit readOnlyHint annotiert; destruktive Tools mit
destructiveHint, sodass gut erzogene Clients vor der Ausführung um
Bestätigung bitten. IDs fließen zwischen den Tools: Beginne mit
list_workspaces, verwende dessen IDs mit list_tasks und so weiter.
Entdecken (rein lesend)
Abschnitt betitelt „Entdecken (rein lesend)“list_workspaces
Abschnitt betitelt „list_workspaces“Keine Parameter. Liefert deine Arbeitsbereiche mit id, Anzeige-name,
personal-Flag und deiner role. Starte hier — jedes andere Tool
braucht eine workspaceId aus dieser Liste.
list_tasks
Abschnitt betitelt „list_tasks“| Parameter | Typ | Hinweise |
|---|---|---|
workspaceId |
string | erforderlich |
status |
PENDING | IN_PROGRESS | DONE |
optionaler Filter |
listId |
string | optionaler Filter |
assigneeId |
string | optionaler Filter (userId eines Mitglieds) |
Liefert kompakte Aufgaben: ID, Titel, Status, Blockierungsgrund (wenn
markiert), Priorität, Fälligkeitsdatum, Liste, zugewiesene Person,
Fortschritt der Unteraufgaben ("2/5 done") und Anzahl der Anhänge.
get_task
Abschnitt betitelt „get_task“workspaceId, taskId. Alle Details einer Aufgabe: Beschreibung,
Ersteller, alle Unteraufgaben mit IDs sowie Anhänge mit IDs, Dateinamen,
Medientypen und Größen.
list_lists
Abschnitt betitelt „list_lists“workspaceId. Liefert die Aufgabenlisten mit IDs und Namen.
list_members
Abschnitt betitelt „list_members“workspaceId. Liefert die Mitglieder mit userId, Name und Rolle — nötig,
um Aufgaben zuzuweisen.
get_attachment
Abschnitt betitelt „get_attachment“workspaceId, taskId, attachmentId. Lädt einen Anhang herunter und
liefert dessen Inhalt: Bilder als Bilder, textartige Dateien (Text, JSON,
XML, CSV, …) als Text (nach 100k Zeichen abgeschnitten), andere
Binärdateien als Base64-Ressource. Verweigert Dateien über 8 MB.
Erstellen und Aktualisieren
Abschnitt betitelt „Erstellen und Aktualisieren“create_task
Abschnitt betitelt „create_task“| Parameter | Typ | Hinweise |
|---|---|---|
workspaceId |
string | erforderlich |
title |
string | erforderlich |
description |
string | optional |
priority |
LOW | NORMAL | HIGH | CRITICAL |
optional |
dueDate |
YYYY-MM-DD |
optional |
listId |
string | optional |
update_task
Abschnitt betitelt „update_task“Dieselben Felder wie create_task plus taskId und assigneeId; nur
übergebene Felder werden geändert, null löscht Priorität,
Fälligkeitsdatum, Liste oder Zuweisung. Als destruktiv annotiert (es
überschreibt bestehende Werte).
set_task_status / set_subtask_status
Abschnitt betitelt „set_task_status / set_subtask_status“workspaceId, taskId (+ subtaskId), done (boolean). Umkehrbar und
idempotent.
add_subtask
Abschnitt betitelt „add_subtask“workspaceId, taskId, title.
create_list
Abschnitt betitelt „create_list“workspaceId, name. Eine Farbe wird automatisch gewählt.
add_attachment
Abschnitt betitelt „add_attachment“| Parameter | Typ | Hinweise |
|---|---|---|
workspaceId, taskId |
string | erforderlich |
fileName |
string | inklusive Dateiendung |
mediaType |
string | optionaler MIME-Typ |
text |
string | Klartext-Inhalt… |
base64 |
string | …oder Binärinhalt — genau eines von beiden |
Inhalte werden pro Arbeitsbereich dedupliziert (deduplicated: true im
Ergebnis); dieselbe Datei zweimal an dieselbe Aufgabe anzuhängen wird
abgelehnt. Limit 8 MB; zählt zum Speicherkontingent des Arbeitsbereichs.
Löschen (destruktiv — Clients fragen zuerst nach)
Abschnitt betitelt „Löschen (destruktiv — Clients fragen zuerst nach)“delete_task
Abschnitt betitelt „delete_task“workspaceId, taskId. Löscht die Aufgabe mitsamt Unteraufgaben und
Anhang-Referenzen. Kann nicht rückgängig gemacht werden.
delete_subtask
Abschnitt betitelt „delete_subtask“workspaceId, taskId, subtaskId.
delete_attachment
Abschnitt betitelt „delete_attachment“workspaceId, taskId, attachmentId. Die gespeicherte Datei wird erst
gelöscht, wenn keine andere Aufgabe denselben Inhalt referenziert.
delete_list
Abschnitt betitelt „delete_list“workspaceId, listId. Aufgaben in der Liste werden nicht gelöscht —
sie bestehen ohne Liste weiter.
Für Assistenten nicht verfügbar
Abschnitt betitelt „Für Assistenten nicht verfügbar“Das Löschen ganzer Arbeitsbereiche und die Mitgliederverwaltung sind bewusst nicht verfügbar — das bleiben menschliche Aktionen in der Todomino-App.