← Todas as ferramentas MCP

Get task

get_task
Somente leitura

O que faz

Get one task in full: notes, metadata, subtasks, any calendar events it's tied to, and the activity feed (comments + status history, each entry naming who wrote it). Call before working a task to load context the human left.

CONTEXT BUDGET: the activity feed returns the NEWEST 50 entries by default. Use limit (0–500) to change that, and include to ask for only the sections you need. Whenever anything is left out, the response carries context_summary saying exactly what — how many older entries exist and which sections you didn't request — so a short payload is never mistaken for a complete history. If it is absent, you have everything. When it says entries were omitted, reach for search_activity rather than assuming; do not infer that a task has no earlier history from a feed that was windowed.

It also resolves all three tiers of the human's standing instructions to you, so you read them in the same call that loads the work: workspace_brief (everything in this workspace), project_brief (everything in this project), and the task's own notes_for_agent. PRECEDENCE: workspace → project → task, most specific last. They are additive context, not a chain where one replaces another — read all three. Where two genuinely conflict, the narrower one is a more recent decision about narrower ground, so it wins: the task's note beats the project brief, which beats the workspace brief. All three are one-way, from the human to you; reply with comment_on_task, or propose new wording for the project or task brief with propose_brief_edit (ask_decision for the workspace one). A task that was sent back and has no brief proposal off it yet carries a one-line brief_hint saying so.

Parâmetros

NomeTipoObrigatórioDescrição
idstringObrigatório
includestring[]Opcional

Which optional sections to load. Omit for all of them. The task itself and all three standing briefs are always returned — they are the human's instructions to you, not an optional section.

Valores permitidossubtasksblockerstagsactivityrunsdecisionscalendar
limitintegerOpcional

Newest activity entries to return (default 50). 0 returns the counts without the entries.

  • De 0 a 500

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:

“Abra a tarefa do checklist de lançamento e leia tudo o que eu deixei nela.”

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 →