List Tasks
list_tasks 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. Return tasks for the authenticated user. Optionally filter by columnId (a single workflow stage), sprintId (tasks attached to a specific sprint), project (by name or id), createdSource (human vs AI), or assignee (executor).
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| columnId | uuid | no | Filter by column ID. |
| sprintId | uuid | no | Filter by sprint ID. |
| project | string | no | Filter by project name (case-insensitive) or id; "none" returns tasks without a project. |
| createdSource | "user" | "mcp" | no | Filter by creator: human ("user") or AI over MCP ("mcp"). |
| assignee | string | no | Filter by executor: a member’s name or email, "me" (the calling agent), or "none" (unassigned). |
Returns
An array of tasks with id, title, description, priority, columnId, sprintId, projectId, dueAt, estimateMinutes, creator attribution, executor and timestamps. Capped at 200 — when it truncates you get truncated: true plus the real total.
Annotations
- read-only. The tool does not mutate server state. Safe to call automatically.
Example
What the user says:
"Show me everything in Doing."What the AI calls under the hood:
json
{
"name": "list_tasks",
"arguments": {
"columnId": "6ff2…"
}
}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.