conecto. Get started
Projects

Find tasks

tasks_list · Reads only · Markdown

Open tasks across projects or in one, most urgent first, filtered by status, assignee, label, priority, due date or words.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What's still open on the sale, most urgent first?

Your agent callstasks_listFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "project": "SALE"
}
What comes back
{
  "tasks": [
    {
      "task": "SALE-1",
      "task_id": 4101,
      "title": "Choose the sale prices with Luis",
      "status": "To do",
      "priority": "urgent",
      "assignee": "luis@halversoncycle.example",
      "labels": [
        "prices"
      ],
      "due_date": "2026-10-15",
      "parent": null,
      "updated_at": "2026-10-14T08:00:00+00:00"
    },
    {
      "task": "SALE-3",
      "task_id": 4103,
      "title": "Photograph the Tabor in sage",
      "status": "To do",
      "priority": "high",
      "assignee": "luis@halversoncycle.example",
      "labels": [
        "photos"
      ],
      "due_date": "2026-10-16",
      "parent": null,
      "updated_at": "2026-10-14T08:00:00+00:00"
    }
  ],
  "count": 5
}

Use it when

Someone asks what is open, overdue or on their plate.

What it does

Tasks across projects or in one, filtered by status, assignee, label, priority, due date or words in the title and description. Open tasks only, unless include_finished; most urgent first.

What comes back

tasks: each with its number, title, status, priority, assignee, labels and due date; and how many matched. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
projectstringA project's key ("WEB") or name. 1 to 80 characters.
statusstringUp to 40 characters.
assigneestringUp to 120 characters.
labelstringUp to 30 characters.
prioritystringOne of: none,low,medium,high,urgent.
due_beforestringMatches ^\d{4}-\d{2}-\d{2}$.
querystringUp to 100 characters.
include_finishedbooleanDefault: false.
limitinteger1 to 100. Default: 50.

The call

Over MCP, call tasks_list on https://api.conecto.chat/mcp/projects. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/tasks_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project":"SALE"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No project has that key or name.Call projects_list and use one of its keys.
invalid_input400The status is not one of the project's, a date is not real, or a subtask's parent is in another project.Use a status the message lists and dates like 2026-10-16.

More Projects tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md