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

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.

list_notifications

List the coach notification inbox, newest first. Archived notifications and technical API/MCP events are excluded. Checkup/intake (health) and bank account/direct debit notifications are never returned, and long messages are shortened with IBAN-like values redacted.
  • Type: Read-only
  • Important Input Fields:
    • unreadOnly (boolean, optional): Only notifications the requesting coach has not read. Requires a coach to be associated with the connection.
    • type (string, optional): Filter by notification type, for example BookingRequestPending.
    • clientId (string, optional): Only notifications about this client.
    • dateFrom / dateTo (string, optional): ISO-8601 range, given together, max 366 days.
    • page (integer, optional): Page number.
    • limit (integer, optional): Items per page.
  • Returns: notificationId, type, title, message, clientId, createdAt, handlingStatus (new or handled) and isRead (null when no coach is associated with the connection).

get_notification

Retrieve one inbox notification with its longer message, category and priority. Technical API/MCP events are excluded.
  • Type: Read-only
  • Important Input Fields:
    • notificationId (string, required): Notification identifier from list_notifications.

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.

list_todos

List the team’s to-dos (the dashboard to-do list, separate from calendar tasks). Filter by status open or completed, clientId, assignedCoachId, priority, due range (YYYY-MM-DD) or search text.
  • Type: Read
  • Input Fields:
    • status (string: open, completed, optional)
    • clientId (string, optional)
    • assignedCoachId (string, optional)
    • priority (string: urgent, high, medium, low, optional)
    • dueFrom (string, optional)
    • dueTo (string, optional)
    • q (string, optional)
    • page (integer, optional)
    • limit (integer, optional)

create_todo Write

Create a to-do on the dashboard to-do list, optionally linked to members and assigned to staff. Get explicit coach confirmation first.
  • Type: Write (requires userConfirmed: true and the write-tool grant)
  • Input Fields:
    • title (string, required)
    • description (string, optional)
    • priority (string: urgent, high, medium, low, optional)
    • dueDate (string, optional)
    • clientIds (array, optional)
    • assignedCoachIds (array, optional)
    • idempotencyKey (string, optional)

update_todo Write

Change a to-do’s title, description, priority, due date or assignees, or complete or reopen it with status. Get explicit coach confirmation first.
  • Type: Write (requires userConfirmed: true and the write-tool grant)
  • Input Fields:
    • todoId (string, required)
    • title (string, optional)
    • description (string, optional)
    • status (string: open, completed, optional)
    • priority (string: urgent, high, medium, low, optional)
    • dueDate (string, optional)
    • assignedCoachIds (array, optional)
    • idempotencyKey (string, optional)

update_notification_status Write

Set one dashboard notification from list_notifications to read, unread, handled, new, archived or unarchived. Get explicit coach confirmation first.
  • Type: Write (requires userConfirmed: true and the write-tool grant)
  • Input Fields:
    • notificationId (string, required)
    • status (string: read, unread, handled, new, archived, unarchived, required)
    • idempotencyKey (string, optional)

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)