CRM

List tasks

crm_list_tasks · Reads only · Markdown

Tasks by status (open by default), for one contact or due before a time, soonest first.

Free*

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

What follow-ups are due before the weekend?

Your agent callscrm_list_tasksFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments

{
  "status": "open",
  "due_before": "2026-10-17T00:00:00+02:00"
}

What comes back

{
  "tasks": [
    {
      "id": 4101,
      "contact_id": 4102,
      "title": "Send the kitchen quote to Hotel Elbblick",
      "details": "",
      "status": "open",
      "priority": "high",
      "due_at": "2026-10-16T10:00:00+00:00",
      "completed_at": null,
      "contact": {
        "id": 4102,
        "name": "Lukas Meyer",
        "email": "lukas.meyer@hotel-elbblick.example"
      }
    }
  ],
  "count": 1
}

Use it when

Someone asks what is due, or a morning round-up of follow-ups is needed.

What it does

Tasks by status (default open), optionally for one contact or due before a time, soonest first, each with the contact it is about (id, name, email).

What comes back

Up to 100 tasks, soonest first, each with its id, the contact it is about (id, name and email), title, details, status, priority and times, and how many were listed. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`status`	string	One of: open,done,cancelled. Default: open.
`contact_id`	integer	At least 1.
`due_before`	string	Up to 40 characters.
`limit`	integer	1 to 100. Default: 25.

The call

Over MCP, call crm_list_tasks on https://api.conecto.chat/mcp/crm. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/crm_list_tasks \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"open","due_before":"2026-10-17T00:00:00+02:00"}'

When it refuses

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

Code	When	What to do
`invalid_input`400	due_before is not an ISO 8601 time.	Send it like 2026-10-17T00:00:00+02:00.

More CRM tools

All 41 tools

Give this to your agent.

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

List tasks

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More CRM tools

Give this to your agent.