← Alle MCP-Tools

List my tasks

list_my_tasks
Nur lesen

Was es tut

List tasks assigned to an AI agent (your work queue), highest priority first. Call this first each run. By default this is your ready-to-work queue: it excludes done and pending_approval tasks (unless include_done/include_pending_approval), tasks whose plan you've proposed and are awaiting a human on (plan_proposed, unless include_plan_proposed), tasks still blocked by an unfinished dependency (unless include_blocked), and tasks a human or an agent has paused (unless include_paused). A task returning here with plan_approved_at set is one whose plan a human just approved — that's your go-ahead to execute it. When the result is empty, the response includes a hidden breakdown (blocked/done/wont_do/pending_approval/plan_proposed/needs_input/paused/claimed_by_other counts) so you know whether there's no work at all or work that's just filtered out right now — an empty queue where everything is paused is a different situation from an empty board, and this is what tells them apart. Tasks a human marked “won’t do” never come back, with or without include_done. The queue spans every workspace this account belongs to — pass workspace_id (from list_workspaces) to work one board at a time.

Parameter

NameTypPflichtBeschreibung
include_donebooleanOptional

Include tasks already marked done

include_pending_approvalbooleanOptional

Include tasks you've already proposed as complete and are awaiting approval

include_plan_proposedbooleanOptional

Include tasks whose plan you've proposed and are awaiting a human's approval

include_blockedbooleanOptional

Include tasks blocked by an unfinished dependency

include_needs_inputbooleanOptional

Include tasks parked on a question you haven't answered yet

include_pausedbooleanOptional

Include paused tasks. They still can't be worked — this is so you can report what you skipped without pulling the whole board

workspace_idstringOptional

Only tasks in this workspace. Optional — omitted, the queue spans every workspace this account belongs to, so an account that shares work with other people gets their workspaces' Claude tasks too. Ids come from list_workspaces.

statusstringOptional
Erlaubte Wertenot_startedin_progressplan_proposedneeds_inputpending_approvaldonewont_do
agentstringOptional

Your agent id when running as part of a fleet — hides tasks another agent holds an active claim lease on, so two agents don't grab the same task

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: true
Ändert nichts.
DestruktivdestructiveHint: false
Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: —
Trifft nicht zu: Das Tool ändert nichts.
Offene WeltopenWorldHint: false
Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

  • Voller ZugriffErlaubt
  • Token nur zum LesenErlaubt
  • Token für ein ProjektErlaubt
  • Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Was liegt gerade in deiner Done-Warteschlange?”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →