---
name: "schedules_list"
area: "schedules"
title: "List schedules"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/schedules_list"
mcp_server: "https://api.conecto.chat/mcp/schedules"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/schedules/schedules_list"
---

# List schedules (`schedules_list`)

Every schedule and waiting one-off run: what it runs and when, as which bot, and how its last run went.

Every schedule on the account: what it runs and when, which bot it runs as, its next run and how its last run went.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To find a schedule_id, or to see what runs on its own.

## Say this to your agent

> What do you have running on a timer for us?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `schedules_list` on the MCP server `https://api.conecto.chat/mcp/schedules` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/schedules_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "schedules_list",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "schedules": [
      {
        "schedule_id": 4102,
        "name": "Remind Rachel about INV-0041",
        "tool": "invoices_remind",
        "arguments": {
          "invoice_id": "c4e6a8c0-2b4d-4f6a-8c0e-3d5f7b9d1e4a",
          "message": "Just a friendly reminder about the repair on your Tabor. Thank you!"
        },
        "timetable": {
          "every": "once",
          "at": "2026-10-23T16:00:00+00:00"
        },
        "runs_when": "once, at 2026-10-23T09:00:00-07:00",
        "time_zone": "America/Los_Angeles",
        "paused": false,
        "done": false,
        "bot": "Pip",
        "next_run_at": "2026-10-23T09:00:00-07:00",
        "last_run_at": null,
        "last_status": null,
        "last_call_id": null,
        "last_error": null,
        "runs": 0
      },
      {
        "schedule_id": 4101,
        "name": "Weekly journal for the accountant",
        "tool": "books_export",
        "arguments": {
          "what": "journal",
          "from": "{today-7}",
          "to": "{today-1}"
        },
        "timetable": {
          "every": "week",
          "days": [
            "mon"
          ],
          "at": "07:00"
        },
        "runs_when": "every Monday at 07:00",
        "time_zone": "America/Los_Angeles",
        "paused": false,
        "done": false,
        "bot": "Pip",
        "next_run_at": "2026-10-19T07:00:00-07:00",
        "last_run_at": null,
        "last_status": null,
        "last_call_id": null,
        "last_error": null,
        "runs": 0
      }
    ],
    "count": 2,
    "paused": 0
  }
}
```

`result`: schedules: each with its schedule_id, name, tool, timetable in words, bot, next run, last run and its status; count; and how many are paused.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [schedules_create](https://conecto.chat/tools/schedules/schedules_create.md): Runs a tool call on a timetable in the business's time zone, from every 15 minutes to once a month; each run is a normal call at the tool's price. $0.50 a call.
- [schedules_run_later](https://conecto.chat/tools/schedules/schedules_run_later.md): Runs one tool call once at a set time, up to a year ahead, with no monthly rent. $0.01 a call.
- [schedules_get](https://conecto.chat/tools/schedules/schedules_get.md): One schedule in full: its next three runs, its last ten runs with their call_ids and costs, and its rent. Free up to 1,000,000 reads a month.
- [schedules_update](https://conecto.chat/tools/schedules/schedules_update.md): Changes a schedule's name, arguments, timetable or time zone, or pauses and resumes it. $0.001 a call.
- [schedules_delete](https://conecto.chat/tools/schedules/schedules_delete.md): Stops a schedule for good, or cancels a one-off run before it runs; past runs stay in the call log. Free.