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
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
include_done | boolean | Facoltativo | Include tasks already marked done |
include_pending_approval | boolean | Facoltativo | Include tasks you've already proposed as complete and are awaiting approval |
include_plan_proposed | boolean | Facoltativo | Include tasks whose plan you've proposed and are awaiting a human's approval |
include_blocked | boolean | Facoltativo | Include tasks blocked by an unfinished dependency |
include_needs_input | boolean | Facoltativo | Include tasks parked on a question you haven't answered yet |
include_paused | boolean | Facoltativo | Include paused tasks. They still can't be worked — this is so you can report what you skipped without pulling the whole board |
workspace_id | string | Facoltativo | 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. |
status | string | Facoltativo | Valori ammessi not_startedin_progressplan_proposedneeds_inputpending_approvaldonewont_do |
agent | string | Facoltativo | 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 lettura
readOnlyHint: true - Non modifica nulla.
- Distruttivo
destructiveHint: false - Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
- Idempotente
idempotentHint: — - Non si applica: lo strumento non modifica nulla.
- Mondo aperto
openWorldHint: 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: