Cosa fa
Atomically pick AND claim the single highest-priority task ready for you to work — the queue's dequeue. Returns one task (already claimed and set to in_progress) or {task:null} when nothing is workable. Prefer this over list_my_tasks+claim_task in a fleet: it closes the race where two agents grab the same task between listing and claiming. Skips done/wont_do/pending_approval/plan_proposed tasks, tasks blocked by an unfinished dependency, paused tasks, and tasks another agent holds an active lease on. When {task:null}, 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 to stop, go unblock something, or wait for a lease to lapse. There is no way to make this hand out a paused task: list_my_tasks({include_paused:true}) can show you one for reporting, but nothing claims one. Like list_my_tasks, this ranks across every workspace the account belongs to unless you pass workspace_id (from list_workspaces).
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
agent | string | Facoltativo | Your agent/model id (e.g. "ChatGPT", "Claude", or a worker name). Used for the claim lease so a fleet doesn't double-book. |
note | string | Facoltativo | Optional note posted to the task's activity when claimed.
|
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. |
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: false - Modifica dati nel tuo account Done.
- Distruttivo
destructiveHint: false - Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
- Idempotente
idempotentHint: false - Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
- 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 letturaRifiutato
- Token per un progettoConsentito
- Token per uno spazio di lavoroConsentito
Provalo
Con Done collegato, chiedi al tuo assistente qualcosa come:
“Prendi la tua prossima attività da Done e inizia.”
Collega Done al tuo assistente
Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client: