← Todas as ferramentas MCP

List my tasks

list_my_tasks
Somente leitura

O que faz

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

NomeTipoObrigatórioDescrição
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

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: true
Não altera nada.
DestrutivadestructiveHint: false
Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: —
Não se aplica: a ferramenta não altera nada.
Mundo abertoopenWorldHint: false
Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

  • Acesso totalPermitido
  • Token somente leituraPermitido
  • Token de um projetoPermitido
  • Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“O que tem na sua fila do Done agora?”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →