← Alle MCP-Tools

Get task

get_task
Nur lesen

Was es tut

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.

Parameter

NameTypPflichtBeschreibung
idstringPflicht
includestring[]Optional

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.

Erlaubte Wertesubtasksblockerstagsactivityrunsdecisionscalendar
limitintegerOptional

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

  • Von 0 bis 500

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: true
Ändert nichts.
DestruktivdestructiveHint: false
Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: —
Trifft nicht zu: Das Tool ändert nichts.
Offene WeltopenWorldHint: false
Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

  • Voller ZugriffErlaubt
  • Token nur zum LesenErlaubt
  • Token für ein ProjektErlaubt
  • Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Öffne die Aufgabe mit der Launch-Checkliste und lies alles, was ich dort hinterlassen habe.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →