conecto. Get started
HR

List checklist tasks

hr_tasks · Reads only · Markdown

Checklist tasks, soonest due first: open, overdue, done or all, for one person, one owner or a date.

Free*

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

An example

Which onboarding tasks are still open for Felix?

Your agent callshr_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
{
  "person": "felix.wagner@hansenvoss.example",
  "status": "open"
}
What comes back
{
  "tasks": [
    {
      "task_id": 4103,
      "title": "Sign the contract and send the tax ID",
      "person": {
        "person_id": 4105,
        "name": "Felix Wagner"
      },
      "owner": "person",
      "owner_person": {
        "person_id": 4105,
        "name": "Felix Wagner",
        "work_email": "felix.wagner@hansenvoss.example"
      },
      "checklist": "Warehouse onboarding",
      "kind": "onboarding",
      "due_date": "2026-10-30",
      "overdue": false,
      "done": false,
      "done_at": null,
      "done_by": null
    },
    {
      "task_id": 4101,
      "title": "Hand over the warehouse keys",
      "person": {
        "person_id": 4105,
        "name": "Felix Wagner"
      },
      "owner": "manager",
      "owner_person": {
        "person_id": 4101,
        "name": "Lena Brandt",
        "work_email": "lena.brandt@hansenvoss.example"
      },
      "checklist": "Warehouse onboarding",
      "kind": "onboarding",
      "due_date": "2026-11-01",
      "overdue": false,
      "done": false,
      "done_at": null,
      "done_by": null
    }
  ],
  "total": 4
}

Use it when

To chase late onboarding steps, or see what is due.

What it does

Checklist tasks, soonest due first: open (default), overdue, done or all; for one person, one owner (person, manager, hr, it), or due on or before a date. Each names who does it: the person or their manager, with their work email.

What comes back

tasks: each with its task_id, title, owner and who does it (with their work email), the person, the due date and whether it is done; and the total. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
personinteger or stringThe person_id, or their work email. 1 to 254 characters, at least 1.
ownerstringOne of: person,manager,hr,it.
due_beforestringOnly tasks due on or before this date. Matches ^\d{4}-\d{2}-\d{2}$.
statusstringOne of: open,overdue,done,all. Default: open.
limitinteger1 to 500. Default: 100.
offsetintegerAt least 0. Default: 0.

The call

Over MCP, call hr_tasks on https://api.conecto.chat/mcp/hr. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hr_tasks \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person":"felix.wagner@hansenvoss.example","status":"open"}'

When it refuses

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

CodeWhenWhat to do
not_found404No person of the business has that person_id or work email.Find them with hr_list_people.
invalid_input400A date is not a date like 2026-10-01, or from is after to.Fix the date.

More HR tools

All 23 tools

Give this to your agent.

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