任务 · MCP

Create Task

create_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. Create a new task on the user's board. Lands in Backlog if no column is set. Priority defaults to medium. Use when the user asks to add a task.

Weft 是为独立创业者和小团队打造的 AI 任务管理工具。

工具参考文档只用英文维护:工具名称、参数和示例在每种语言下都完全相同。

参数

名称类型必填说明
titlestring是Short, specific task title.
descriptionstring否Markdown description with any context.
priority"low" | "medium" | "high" | "urgent"否Defaults to "medium".
columnIduuid否Column to place the task in. Omit to land in Backlog.
sprintIduuid否Attach the task to this sprint.
projectstring否Project to file the task under — name (case-insensitive) or id.
assigneestring否Executor — a member’s name or email, or "me" to assign to the calling agent. A task has one executor: a person or an agent.
estimateMinutesinteger否Honest guess of work time in minutes.
dueAtISO-8601 datetime string否The day it is due — only the date part is used. Dated tasks show on the Weft calendar and in a subscribed Google/Apple/Outlook calendar.
startAtISO-8601 datetime string否The day work begins. With dueAt it makes a span on the calendar; never after dueAt.
requiresReviewboolean否Stop at the user before this counts as done. For the irreversible only — money, publishing outward, production, anything legal; everything else finishes without them.
verification{ mode, checks[] }否How "done" will be checked — the server executes these checks on complete_task. mode "executable"/"state_delta" lets fully-passed work close itself; "checklist"/"human" always stops at you. Check kinds: http (url → expected status + optional mustContain), citation (url + quote that must appear on the page), string_check, file_hash (sha256 among the artifacts), human_checklist (items only you can judge — resolved when you accept). Statuses and results are written by the server only.
blockedByuuid[]否Tasks that must finish first. The task derives agentState "blocked" while any is open and leaves ready-sets; it unblocks the moment the last blocker completes. Cycles are refused.

返回

The newly created task with its generated id and position.

标注

默认的写入工具。它会改变状态;MCP 客户端一旦清楚用户想要什么,就可以直接调用。是否请用户确认由客户端自己决定;Model Context Protocol 规范建议让人参与其中,并保留拒绝工具调用的能力。

示例

用户会这样说:

"Add a high-priority task: fix flaky CI tests."

AI 在背后这样调用:

json
{
  "name": "create_task",
  "arguments": {
    "title": "Fix flaky CI tests",
    "priority": "high"
  }
}

相关