← Todas las herramientas MCP

Get next task

next_task
Escritura

Qué hace

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).

Parámetros

NombreTipoObligatorioDescripción
agentstringOpcional

Your agent/model id (e.g. "ChatGPT", "Claude", or a worker name). Used for the claim lease so a fleet doesn't double-book.

notestringOpcional

Optional note posted to the task's activity when claimed.

  • Hasta 20000 caracteres
workspace_idstringOpcional

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.

Anotaciones

Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.

Solo lecturareadOnlyHint: false
Cambia datos de tu cuenta de Done.
DestructivadestructiveHint: false
Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: false
Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
Mundo abiertoopenWorldHint: false
Solo toca tu propia cuenta de Done.

Qué tokens pueden llamarla

Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.

  • Acceso completoPermitido
  • Token de solo lecturaRechazado
  • Token de un proyectoPermitido
  • Token de un espacio de trabajoPermitido

Pruébala

Con Done conectado, pídele a tu asistente algo como:

“Toma tu siguiente tarea de Done y empieza con ella.”

Conecta Done a tu asistente

Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente:

Resumen de la configuración de MCP →