← Tutti gli strumenti MCP

List my tasks

list_my_tasks
Sola lettura

Cosa fa

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.

Parametri

NomeTipoObbligatorioDescrizione
include_donebooleanFacoltativo

Include tasks already marked done

include_pending_approvalbooleanFacoltativo

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

include_plan_proposedbooleanFacoltativo

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

include_blockedbooleanFacoltativo

Include tasks blocked by an unfinished dependency

include_needs_inputbooleanFacoltativo

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

include_pausedbooleanFacoltativo

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

workspace_idstringFacoltativo

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.

statusstringFacoltativo
Valori ammessinot_startedin_progressplan_proposedneeds_inputpending_approvaldonewont_do
agentstringFacoltativo

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

Annotazioni

Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.

Sola letturareadOnlyHint: true
Non modifica nulla.
DistruttivodestructiveHint: false
Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: —
Non si applica: lo strumento non modifica nulla.
Mondo apertoopenWorldHint: false
Tocca solo il tuo account Done.

Quali token possono chiamarlo

Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.

  • Accesso completoConsentito
  • Token di sola letturaConsentito
  • Token per un progettoConsentito
  • Token per uno spazio di lavoroConsentito

Provalo

Con Done collegato, chiedi al tuo assistente qualcosa come:

“Cosa c’è adesso nella tua coda di Done?”

Collega Done al tuo assistente

Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client:

Panoramica della configurazione MCP →