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 es el gestor de tareas con IA para fundadores en solitario y equipos pequeños.
La referencia de herramientas se mantiene en inglés: los nombres de las herramientas, los argumentos y los ejemplos son idénticos en todos los idiomas.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| title | string | sí | Short, specific task title. |
| description | string | no | Markdown description with any context. |
| priority | "low" | "medium" | "high" | "urgent" | no | Defaults to "medium". |
| columnId | uuid | no | Column to place the task in. Omit to land in Backlog. |
| sprintId | uuid | no | Attach the task to this sprint. |
| project | string | no | Project to file the task under — name (case-insensitive) or id. |
| assignee | string | no | 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 | no | Honest guess of work time in minutes. |
| dueAt | ISO-8601 datetime string | no | 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 | no | The day work begins. With dueAt it makes a span on the calendar; never after dueAt. |
| requiresReview | boolean | no | 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[] } | no | 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[] | no | 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. |
Devuelve
The newly created task with its generated id and position.
Anotaciones
Herramienta de escritura por defecto. La herramienta modifica el estado; los clientes MCP pueden llamarla libremente en cuanto sepan qué quiere el usuario. Que el cliente pida confirmación o no es decisión del cliente; la especificación del Model Context Protocol recomienda mantener a una persona en el circuito, con la posibilidad de denegar invocaciones de herramientas.
Ejemplo
Lo que dice el usuario:
"Add a high-priority task: fix flaky CI tests."Lo que la IA llama por debajo:
{
"name": "create_task",
"arguments": {
"title": "Fix flaky CI tests",
"priority": "high"
}
}Relacionado
- Las 32 herramientas MCP — la vista de catálogo.
- Shuttle — cómo el cliente de IA usa estas herramientas.
- Llama a esta herramienta desde tu propio cliente: consulta las guías de configuración o accede directamente a
https://letsweft.com/api/mcp.