> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar Tasks

> Reference for managing coach and client checklist tasks.

The `calendar_tasks` module provides tools to view, track, create, update, and
cancel checklist tasks.

| Key                  | Value            |
| :------------------- | :--------------- |
| **Module Key**       | `calendar_tasks` |
| **Sensitivity**      | `operational`    |
| **Consent Required** | None             |

***

## Available Tools

### `list_calendar_tasks`

List pending and completed checklist tasks.

* **Type:** Read-only
* **Important Input Fields:**
  * `clientId` (string, optional): Filter tasks linked to a specific client.
  * `coachId` (string, optional): Filter tasks assigned to a specific coach.
  * `status` (string, optional): Filter by status (e.g. `pending`, `completed`).

### `get_calendar_task`

Retrieve details of a specific checklist task.

* **Type:** Read-only
* **Important Input Fields:**
  * `taskId` (string, required): Unique task identifier.

### `create_calendar_task` **`Write`**

Create a new checklist task.

* **Type:** Write
* **Important Input Fields:**
  * `title` (string, required): The task's title.
  * `description` (string, optional): Detailed notes for the task.
  * `clientId` (string, optional): Link this task to a client.
  * `dueAt` (string, optional): Optional ISO-8601 due date.

### `cancel_calendar_task` **`Write`**

Cancel or delete a checklist task within the caller's company.

* **Type:** Write
* **Important Input Fields:**
  * `taskId` (string, required): Unique task identifier.

### `update_calendar_task` **`Write`**

Update title, notes, timing, or assigned coaches for an existing task.

* **Type:** Write
* **Important Input Fields:**
  * `taskId` (string, required): Unique task identifier.
  * `title` (string, optional): Updated title.
  * `notes` (string, optional): Updated notes.
  * `startAt` (string, optional): Updated ISO-8601 start date-time.
  * `endAt` (string, optional): Updated ISO-8601 end date-time.
  * `durationMinutes` (integer, optional): Updated task duration.

***

## Natural Language Examples

* *"List all pending tasks assigned to coach coach\_9921."*
* *"Create a task to review Jane Doe's weight log next Friday."*
* *"Move task task\_abc123 to tomorrow at 10:00."*

***

## JSON-RPC Call Example (`create_calendar_task`)

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "tasks-1",
  "method": "tools/call",
  "params": {
    "name": "create_calendar_task",
    "arguments": {
      "title": "Review client goals",
      "description": "Examine weekly metrics",
      "clientId": "client_abc123"
    }
  }
}
```