Tools & Annotations

Die vollständige Liste kommt live aus tools/list. Hier die wichtigsten Konzepte für den Umgang mit den Listen-/Aufgaben-Tools.

Filter auf list_list_items

Serverseitige Filter sparen das Nachfiltern und reduzieren die Antwortgröße:

Parameter	Wirkung
state	open / done / all
assigned_to_me	nur mir zugewiesene Items (kein get_me nötig)
due_within_days	bald fällige (inkl. überfällige)
due_before	fällig vor ISO-Datum
sort	priority / due_date / created / modified
compact	schlanke Antwort (weniger Tokens)

{"name":"list_list_items",
 "arguments":{"state":"open","assigned_to_me":true,"compact":true}}

Nützliche dedizierte Tools

• get_my_open_items — „Was steht bei mir an?" (überfällig → fällig → Priorität)
• complete_list_item / complete_list_items — abhaken (einzeln/Bulk)
• list_recent_changes — Sync/Polling: was hat sich seit since geändert
• get_metadata — gültige Status/Priorität/scope-Werte
• search_ai_messages — Claude-Code-KI-Chatverlauf durchsuchen/filtern
• get_ai_chat_history — vollständigen KI-Chat-Verlauf eines Items lesen (ohne Kürzung)

search_ai_messages

Durchsucht/filtert den Claude-Code-KI-Chatverlauf des Teams (Konversationen an List-Items/Listen):

Parameter	Wirkung
query	Volltext-Suche im Message-Content (optional — ohne query wird nur gefiltert)
listId	auf eine Liste einschränken — UUID, SID oder Listen-Nummer ("177"/"#177")
itemId	auf ein Item einschränken — UUID, SID, oder "#<listNum>.<itemNum>" (z. B. "#177.252", wie in UI/Commit-Titeln); eine blanke Item-Nummer nur zusammen mit listId, da list_items.num nur pro Liste eindeutig ist
userId	nur Konversationen dieses Erstellers
role	user / assistant / tool
dateFrom / dateTo	Zeitraum (ISO 8601)
limit / offset	Pagination (max. 200)

{"name":"search_ai_messages",
 "arguments":{"itemId":"#177.252","query":"Rate Limit","role":"assistant"}}

Sichtbarkeit ist fest verdrahtet, nicht per Rolle umgehbar: Eine Konversation ist entweder public (sichtbar für jeden mit Zugriff auf das zugrunde liegende Item/die Liste) oder private (Default — ausschließlich für den eigenen Ersteller sichtbar, kein Bypass für admin/owner). Details: public-api/docs/MCP-TOOL-AI-MESSAGES.md.

get_ai_chat_history

Liest den vollständigen KI-Chat-Verlauf eines Items — über alle seine Threads hinweg, mit vollem Message-Content statt gekürztem Snippet:

Parameter	Wirkung
itemId	UUID oder SID des Items (erforderlich)
dateFrom / dateTo	Zeitraum (ISO 8601) — schränkt ein, damit nicht immer der gesamte Verlauf geladen werden muss

{"name":"get_ai_chat_history",
 "arguments":{"itemId":"<UUID>","dateFrom":"2026-07-04T00:00:00Z"}}

Gleiche Sichtbarkeitsregel wie search_ai_messages (public vs. private pro Thread, kein Rollen-Bypass). Details: public-api/docs/MCP-TOOL-AI-CHAT-HISTORY.md.

Annotations

Jedes Tool trägt in tools/list Verhaltens-Hinweise, damit Clients Read-Tools automatisch erlauben und vor destruktiven warnen:

Tool	Art
list_list_items	read-only
update_list_item	write · idempotent
delete_list_item	destructive

readOnlyHint, destructiveHint, idempotentHint, openWorldHint.

Paginierung & compact

Alle List-Tools unterstützen compact:true. Paginierte Tools liefern has_more — danach offset erhöhen, bis has_more:false.