Offene Elemente auflisten, bevor neue hinzugefügt werden
Vorheriges Lesen vermeidet doppelte TODOs, wenn mehrere Agenten im selben Projektbereich arbeiten.
todo({ action: "list" })Öffentliches MCP-Tool
todo
Zweck
Projekt-TODOs erstellen, aktualisieren, abschließen, auflisten oder explizit per Massenlöschung bereinigen, während der Aufgabenstatus im autorisierten Projektkontext verbleibt.
Wann zu verwenden
- Aufgaben, Übergabenotizen oder Aktionspunkte für ein bestimmtes Projekt nachverfolgen.
- Den Status einer bestehenden Projektaufgabe auf 'completed' oder 'in_progress' setzen.
- Offene oder überfällige Aufgaben auflisten, bevor neue Arbeit begonnen wird.
Wann NICHT zu verwenden
- Verwenden Sie es nicht für allgemeine Wissensfakten; nutzen Sie remember für dauerhaftes Wissen.
- Verwenden Sie es nicht für finanzielle Ausgaben oder Budgetposten; nutzen Sie ledger.
- Verwenden Sie es nicht für temporäre Chat-Notizen, die nach dem Gespräch wertlos sind.
- Verwenden Sie confirm_delete_all nicht leichtfertig; eine Massenlöschung erfordert explizite Bestätigung.
Erforderlicher Scope
- memory:read für Leseaktionen (list, get).
- memory:write für Änderungsaktionen (create, update, complete, delete, delete_all).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action | create | update | complete | list | delete_all · erforderlich | Auszuführende Aktion: create, update, complete, list, delete oder delete_all. |
todo_id | string | Eindeutige Aufgaben-ID für Aktualisierungen, Abschluss oder Einzel-Löschungen. |
content / title | string | Titel oder inhaltliche Beschreibung der Aufgabe bei Neuerstellung oder Aktualisierung. |
project_id | string | Zugehörige Projektkennung zur Verknüpfung der Aufgabe mit einem Projektkontext. |
priority / due_at / status / note | string | Optionale Metadaten: Priorität (low/medium/high), Fälligkeitsdatum, Status oder ergänzende Notiz. |
item_status / due_before / search / query | string | Filterparameter für die Listenansicht: Statusfilter (open/completed), Fristen oder Suchbegriffe. |
limit / cursor / owner_timezone | integer / string · Standard: 20 / empty / configured timezone | Paginierungs- und Zeitzonenparameter zur Steuerung der Ergebnisliste. |
client_mutation_id / expected_version | string / integer | Idempotenz-Schlüssel und erwartete Versionsnummer zur Vermeidung von Schreibkonflikten. |
confirm_delete_all | boolean · Standard: false | Explizite Sicherheitsbestätigung, die auf true gesetzt sein muss, um delete_all auszuführen. |
Rückgabeschema
Die strukturierte Ausgabe identifiziert die Aktion und liefert die betroffenen Elemente, den Paginierungs-Cursor, den Mutationsstatus und sichere Aufgabenmetadaten zurück. Die Massenlöschung erfolgt stets als wiederherstellbare Soft-Löschung.
Beispiele
todo({
action: "create",
content: "Review the MCP scope matrix",
client_mutation_id: "task-review-scope-001",
due_at: "2026-08-25T09:00:00Z"
})todo({ action: "list", item_status: "open", limit: 10 })Fehler
- 401/403: Das MCP-Token fehlt oder gewährt nicht den erforderlichen Geltungsbereich (memory:read / memory:write).
- 404: Die angegebene todo_id existiert im angegebenen Projekt nicht.
- Validierungsfehler: Fehlende Pflichtfelder für die gewählte Aktion oder ungültiger Statusübergang.
- Sicherheitskonflikt: delete_all aufgerufen ohne confirm_delete_all: true.
Zugehörige Tools
- remember — Dauerhaften Architektur- und Kontextfakt statt flüchtiger Aufgaben speichern.
- recall_context — Projektkontext und relevante Erinnerungen vor der Aufgabenbearbeitung laden.
- forget — Veraltetes Speicherwissen bereinigen statt Projektaufgaben zu schließen.
Quelle: SDK-Workflow-Hilfsprogramme