← Todas las herramientas MCP

List my tasks

list_my_tasks
Solo lectura

Qué hace

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.

Parámetros

NombreTipoObligatorioDescripción
include_donebooleanOpcional

Include tasks already marked done

include_pending_approvalbooleanOpcional

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

include_plan_proposedbooleanOpcional

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

include_blockedbooleanOpcional

Include tasks blocked by an unfinished dependency

include_needs_inputbooleanOpcional

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

include_pausedbooleanOpcional

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

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.

statusstringOpcional
Valores permitidosnot_startedin_progressplan_proposedneeds_inputpending_approvaldonewont_do
agentstringOpcional

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

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: true
No cambia nada.
DestructivadestructiveHint: false
Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: —
No aplica: la herramienta no cambia nada.
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 lecturaPermitido
  • Token de un proyectoPermitido
  • Token de un espacio de trabajoPermitido

Pruébala

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

“¿Qué tienes ahora en tu cola de Done?”

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 →