Complete Task
complete_task is one of the 32 MCP tools in Weft, the AI task manager you run by talking to Claude, Cursor, Codex or ChatGPT through one MCP endpoint. The AI calls this when the work is actually finished — the card moves to Done with completion time recorded, and the optional outcome (what was done, where the result lives) is appended to the card as an "Outcome (AI, date)" note. No column id needed. Work marked as needing you does NOT move to Done: it goes to your queue with the receipt attached, and if the agent said what it would do next, accepting approves exactly that step and hands it back to the agent. If the task carries a verification plan, the server executes its checks right here — fetching the URL, looking for the quote, comparing the hash: an executable/state_delta plan whose blocking checks all pass closes verified by the server; a failed blocking check keeps the card out of Done and shows the agent what the server observed.
Weft is the AI task manager for solo founders and small teams.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | yes | Task id to complete. |
| outcome | string | no | 1-3 sentences: what was done and where the result lives. |
| artifacts | { kind, uri }[] | no | Evidence a person could check without trusting the account of it — a URL, a hash, a message id. |
| learnings | (string | { trigger, content })[] | no | Up to 3 lessons worth remembering beyond this task — they become memory notes and surface in every future get_my_work, stamped with source and date. |
| nextStep | string | no | What the agent would do next if you accept (≤200 chars) — shown above the Accept button, so accepting approves exactly that. |
Returns
The task, now in Done with completedAt set — or awaitingReview:true when it stopped at you instead.
Annotations
Default write tool. The tool mutates state; MCP clients are free to call it once they know what the user wants. Whether the client asks for confirmation is the client’s choice; the Model Context Protocol specification recommends keeping a human in the loop with the ability to deny tool invocations.
Example
What the user says:
"Mark the deploy task done — released in v1.2.0."Related
- All 32 MCP tools — the catalog view.
- Shuttle — how the AI client uses these tools.
- Call this tool through your own client: see setup guides, or hit
https://letsweft.com/api/mcpdirectly.