Ce qu’il fait
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).
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
agent | string | Facultatif | 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 | Facultatif | Optional note posted to the task's activity when claimed.
|
workspace_id | string | Facultatif | 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. |
Annotations
Les indications que le serveur envoie avec cet outil. Un client les lit pour décider s’il doit vous demander avant un appel.
- Lecture seule
readOnlyHint: false - Modifie des données de votre compte Done.
- Destructif
destructiveHint: false - Ajoute ou lit seulement ; rien de ce qui existe n’est supprimé ni écrasé.
- Idempotent
idempotentHint: false - Chaque appel peut ajouter quelque chose de nouveau : un commentaire, une exécution, une tâche.
- Monde ouvert
openWorldHint: false - Ne touche que votre propre compte Done.
Quels jetons peuvent l’appeler
Une connexion établie avec OAuth a un accès complet. Un jeton créé dans Réglages → Accès des agents → Jetons MCP supplémentaires peut être restreint, et un jeton restreint ne voit jamais au-delà de son projet ou de son espace de travail.
- Accès completAutorisé
- Jeton en lecture seuleRefusé
- Jeton limité à un projetAutorisé
- Jeton limité à un espace de travailAutorisé
Essayez
Une fois Done connecté, demandez à votre assistant quelque chose comme :
“Prenez votre prochaine tâche dans Done et commencez-la.”
Connectez Done à votre assistant
Un point d’accès MCP par compte, via OAuth ou un jeton. La configuration pas à pas pour chaque client :