Zum Inhalt
Für Agenten

MCP Reference

calendar_project_tasks_list

Read Project Workload on a Workspace Calendar

Markdown Tools als JSON

Beschreibung

Read live tasks from projects displayed on a shared workspace calendar. Both calendar and project/task access are required. Workspace agents are restricted to their authenticated workspace. from/to are YYYY-MM-DD, to is exclusive, maximum 62 days. Task due_on is inclusive. A single date is a marker; undated_count counts tasks with neither date. Peak counts simultaneous open tasks, never working hours. Completed tasks are excluded by default; canceled/archived work is always excluded. Up to 1000 matching tasks contribute to workload; truncated explicitly marks incomplete totals. Page through these tasks with offset (200/page), or narrow dates/assignee if truncated. Use existing task tools to change the originals.

Zugriff

Zugriffsprofil: gated. Module: calendar. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
workspace_id string Ja
calendar_id string Ja
from string Ja
to string Ja
assignee_id string Nein user_ prefix or unassigned; omit for everyone.
include_completed boolean Nein
offset integer Nein

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string"
    },
    "calendar_id": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "assignee_id": {
      "type": "string",
      "description": "user_ prefix or unassigned; omit for everyone."
    },
    "include_completed": {
      "type": "boolean"
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "account_id",
    "workspace_id",
    "calendar_id",
    "from",
    "to"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ]
      }
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "key": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          },
          "assignee_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "start_on": {
            "type": [
              "string",
              "null"
            ]
          },
          "due_on": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "key",
          "title",
          "project_id",
          "assignee_id",
          "start_on",
          "due_on",
          "status"
        ]
      }
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "task_count": {
            "type": "integer"
          },
          "peak_open_tasks": {
            "type": "integer"
          }
        },
        "required": [
          "user_id",
          "name",
          "task_count",
          "peak_open_tasks"
        ]
      }
    },
    "undated_count": {
      "type": "integer"
    },
    "truncated": {
      "type": "boolean"
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "projects",
    "tasks",
    "people",
    "undated_count",
    "truncated",
    "has_more",
    "next_offset"
  ],
  "type": "object"
}
Seiten