# todos

Halten Sie den Aufgabenstatus und Übergabenotizen stets nah am Projektkontext, der sie nützlich macht.

- Canonical: https://docs.xmemo.dev/de/docs/tools/todos
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 191848e34c6130ea7c7026f86e247cf62ccb063ecf6fa01d5f4acce533a64867
- Edition-Digest: ebed72c78550c96aca78228a41236e53e3f7f9f3e83ef5708438acf784a1d8a0
- Source-Revision: sha256:a208365f51d49c201b173728a752a5cec89775c71d38b55619b7bdb6846d5717

## Tool Reference: `todo`

### Purpose

Projekt-TODOs erstellen, aktualisieren, abschließen, auflisten oder explizit per Massenlöschung bereinigen, während der Aufgabenstatus im autorisierten Projektkontext verbleibt.

### Parameters

- `action` (create | update | complete | list | delete_all, required): Auszuführende Aktion: create, update, complete, list, delete oder delete_all.
- `todo_id` (string, optional): Eindeutige Aufgaben-ID für Aktualisierungen, Abschluss oder Einzel-Löschungen.
- `content / title` (string, optional): Titel oder inhaltliche Beschreibung der Aufgabe bei Neuerstellung oder Aktualisierung.
- `project_id` (string, optional): Zugehörige Projektkennung zur Verknüpfung der Aufgabe mit einem Projektkontext.
- `priority / due_at / status / note` (string, optional): Optionale Metadaten: Priorität (low/medium/high), Fälligkeitsdatum, Status oder ergänzende Notiz.
- `item_status / due_before / search / query` (string, optional): Filterparameter für die Listenansicht: Statusfilter (open/completed), Fristen oder Suchbegriffe.
- `limit / cursor / owner_timezone` (integer / string, optional, default: 20 / empty / configured timezone): Paginierungs- und Zeitzonenparameter zur Steuerung der Ergebnisliste.
- `client_mutation_id / expected_version` (string / integer, optional): Idempotenz-Schlüssel und erwartete Versionsnummer zur Vermeidung von Schreibkonflikten.
- `confirm_delete_all` (boolean, optional, default: false): Explizite Sicherheitsbestätigung, die auf true gesetzt sein muss, um delete_all auszuführen.

### Returns

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.

### Errors

- 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.

### Examples

#### Eine idempotente Aufgabe erstellen



```typescript
todo({
  action: "create",
  content: "Review the MCP scope matrix",
  client_mutation_id: "task-review-scope-001",
  due_at: "2026-08-25T09:00:00Z"
})
```

#### Offene Aufgaben auflisten



```typescript
todo({ action: "list", item_status: "open", limit: 10 })
```

### Related Tools

- [remember](/docs/tools/remember): Dauerhaften Architektur- und Kontextfakt statt flüchtiger Aufgaben speichern.
- [recall_context](/docs/tools/recall-context): Projektkontext und relevante Erinnerungen vor der Aufgabenbearbeitung laden.
- [forget](/docs/tools/forget): Veraltetes Speicherwissen bereinigen statt Projektaufgaben zu schließen.

## Offene Elemente auflisten, bevor neue hinzugefügt werden

Vorheriges Lesen vermeidet doppelte TODOs, wenn mehrere Agenten im selben Projektbereich arbeiten.

```ts
todo({ action: "list" })
```