任務 · 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 任務管理工具。

工具參考文件以英文維護：工具名稱、參數與範例在每種語言中都相同。

參數

名稱	型別	必填	說明
title	string	是	Short, specific task title.
description	string	否	Markdown description with any context.
priority	"low" \| "medium" \| "high" \| "urgent"	否	Defaults to "medium".
columnId	uuid	否	Column to place the task in. Omit to land in Backlog.
sprintId	uuid	否	Attach the task to this sprint.
project	string	否	Project to file the task under — name (case-insensitive) or id.
assignee	string	否	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.
estimateMinutes	integer	否	Honest guess of work time in minutes.
dueAt	ISO-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.
startAt	ISO-8601 datetime string	否	The day work begins. With dueAt it makes a span on the calendar; never after dueAt.
requiresReview	boolean	否	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.
blockedBy	uuid[]	否	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"
  }
}

參數

回傳

註記

範例

相關