1. Docs
2. /
3. Tool reference
4. /
5. Tasks & My Day
6. /
7. listTasks

Tasks & My Day

listTasks

List Tasks

List Tasks with optional text, status, priority, assignee, list, project, completion, and due-date filters.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what are my tasks", and it calls listTasks.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {},
  "name": "listTasks"
}

Arguments

• assigneeIdstringoptionalNo description is declared in the tool schema.
• completedbooleanoptionalNo description is declared in the tool schema.
• cursorstringoptionalnextCursor from the previous page. Omit for the first page.
• dueAfternumberoptionalNo description is declared in the tool schema.
• dueBeforenumberoptionalNo description is declared in the tool schema.
• labelIdstringoptionalNo description is declared in the tool schema.
• limitnumberoptionalHow many tasks to return. Default 50, maximum 200. A larger ask is clamped, never refused.
• listIdstringoptionalNo description is declared in the tool schema.
• prioritystringoptionalAllowed values: low, medium, high, urgent.
• projectIdstringoptionalNo description is declared in the tool schema.
• searchstringoptionalNo description is declared in the tool schema.
• statusIdstringoptionalNo description is declared in the tool schema.

Returns

PAGED: a call returns at most limit tasks (default 50, maximum 200; a larger ask is clamped, never refused) alongside totalMatched (how many tasks the filters matched in all), hasMore, and…

Ask for it

The Cloud routes these requests to this verb.

• what are my tasks
• show my to-dos
• what do I need to do
• plate review
• what is on my plate
• review every list

Pair it with

The verbs that finish the job.

• readTask
• createTask
• updateTask
• completeMatchingTodo

Questions

• What does listTasks do?

  List Tasks with optional text, status, priority, assignee, list, project, completion, and due-date filters. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listTasks from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what are my tasks", and it calls listTasks.

• Is listTasks safe to let an AI call?

  listTasks is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.