MCP-Tools: List Items
Aufgaben („Items") leben in Listen. Zuweisungen stehen in refs ({type:'user',id}) und werden als assignees zurückgegeben.
list_list_items
Items filtern. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
listId | string | – | Nach Liste filtern |
state | enum open | done | all | all | open = nicht erledigt (Status nicht done/completed) |
status | string | – | Exakter Status (z. B. todo). Für „nicht fertig" lieber state |
priority | number (1–9) | – | Nach Priorität |
assigned_to | string | – | Nach zugewiesenem User (refs, type=user) |
assigned_to_me | boolean | – | Nur mir zugewiesene (kein get_me nötig) |
tag | string | – | Exakter Tag (z. B. ki/claude) |
search | string | – | Suche in Text und Beschreibung |
due_within_days | number | – | Fällig in N Tagen (inkl. überfällig) |
due_before | string (ISO) | – | Fällig vor Datum |
includeArchived | boolean | false | Archivierte einschließen |
sort | enum default | priority | due_date | created | modified | default | Sortierung |
compact | boolean | false | Nur Kernfelder + assignees |
limit | number | 50 | Anzahl |
offset | number | 0 | Überspringen |
Antwort: { items, total, limit, offset, has_more }.
get_list_item
Ein Item. read · follower
| Parameter | Typ | Beschreibung |
|---|---|---|
itemId | string (erforderlich) | UUID oder SID |
create_list_item
Neues Item. write · user
| Parameter | Typ | Beschreibung |
|---|---|---|
listId | string (erforderlich) | UUID oder SID der Liste |
text | string (erforderlich) | Titel (min. 1 Zeichen) |
description | string | Beschreibung |
status | string | Status |
priority | number (1–9) | Priorität (9 = urgent) |
assigned_to | string[] | Zugewiesene User-IDs |
tags | string[] | Tags |
target_date | string (ISO) | Fälligkeitsdatum |
parent | string | Übergeordnetes Item |
update_list_item
Item ändern. write · user
| Parameter | Typ | Beschreibung |
|---|---|---|
itemId | string (erforderlich) | UUID oder SID |
text, description, status | string | neue Werte |
priority | number (1–9) | neue Priorität |
assigned_to | string[] | neue Zuweisungen |
tags | string[] | neue Tags |
target_date | string | null | neues Datum |
progress | number (0–100) | Fortschritt |
archived | boolean | archivieren |
expectedVersion | integer | Optimistic Lock |
complete_list_item
Als erledigt markieren (Status done, Progress 100). write · user
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
itemId | string (erforderlich) | – | UUID oder SID |
reopen | boolean | false | Wieder öffnen (Status open, Progress 0) |
expectedVersion | integer | – | Optimistic Lock |
complete_list_items
Mehrere abhaken/öffnen (Bulk). write · user
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
itemIds | string[] (erforderlich) | – | UUIDs/SIDs (min. 1) |
reopen | boolean | false | Wieder öffnen statt abhaken |
Antwort: { succeeded, failed, results[] } (Per-Item-Ergebnis).
update_list_items
Gleiche Feld-Updates auf mehrere Items (Bulk). write · user
| Parameter | Typ | Beschreibung |
|---|---|---|
itemIds | string[] (erforderlich) | UUIDs/SIDs (min. 1) |
status | string | für alle |
priority | number (1–9) | für alle |
assigned_to | string[] | für alle |
tags | string[] | für alle |
target_date | string | null | für alle |
progress | number (0–100) | für alle |
archived | boolean | für alle |
delete_list_item
In den Papierkorb. destructive · admin
| Parameter | Typ | Beschreibung |
|---|---|---|
itemId | string (erforderlich) | UUID oder SID |
expectedVersion | integer | Optimistic Lock |
get_overdue_list_items
Überfällige Items. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
listId | string | – | Nach Liste |
compact | boolean | false | Kernfelder + days_overdue |
limit | number | 50 | Anzahl |
get_my_open_items
Meine offenen Aufgaben (überfällig → fällig → Priorität). read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
listId | string | – | Auf eine Liste beschränken |
includeUndated | boolean | true | Auch Items ohne Datum |
compact | boolean | false | Kernfelder |
limit | number | 50 | Anzahl |
list_recent_changes
Kürzlich geänderte Items (Sync/Polling). read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
since | string (ISO) | – | Nur ab diesem Zeitpunkt geändert |
listId | string | – | Auf eine Liste beschränken |
compact | boolean | false | Kernfelder + modified |
limit | number | 50 | Anzahl |
search_list_items
Volltextsuche über Items. read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
query | string (erforderlich) | – | Suchbegriff (min. 1 Zeichen) |
compact | boolean | false | Kernfelder |
limit | number | 20 | Anzahl |
post_chat_message
Nachricht in den Chat eines Items (oder einer Liste). write · user
| Parameter | Typ | Beschreibung |
|---|---|---|
itemId | string | Ziel-Item (UUID/SID) |
listId | string | Ziel-Liste (Alternative zu itemId) |
text | string (erforderlich) | Nachrichtentext |
get_chat_messages
Chat-Verlauf lesen (älteste zuerst). read · follower
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
itemId | string | – | Item-Chat |
listId | string | – | Listen-Chat (Alternative) |
limit | number | 50 | Max. Nachrichten |
offset | number | 0 | Überspringen |
get_metadata
Referenz: gültige Status/Priorität/scope/Filter-Werte. read · guest
Keine Parameter. Vor dem Anlegen/Ändern aufrufen, um korrekte Werte zu nutzen.