ClickUp MCP Server

Instructions

Implementation Reference

• src/clickup_mcp/tools.py:793-818 (handler)

  MCP tool handler for 'get_subtasks'. Resolves parent task ID, fetches subtasks via client, and formats the response dictionary.

  async def get_subtasks(self, parent_task_id: str) -> Dict[str, Any]:
      """Get subtasks of a parent task."""
      try:
          # First resolve the task to get the internal ID
          task = await self._resolve_task_id(parent_task_id)
          # Use the client's proper subtasks method
          subtasks = await self.client.get_subtasks(task.id)
  
          return {
              "parent_id": task.id,
              "subtasks": [
                  {
                      "id": task.id,
                      "name": task.name,
                      "status": task.status.status,
                      "assignees": [u.username for u in task.assignees],
                      "url": format_task_url(task.id),
                      "custom_id": task.custom_id if task.custom_id else None,
                  }
                  for task in subtasks
              ],
              "count": len(subtasks),
          }
      except Exception as e:
          return {"error": f"Failed to get subtasks for '{parent_task_id}': {e!s}"}

• src/clickup_mcp/tools.py:197-207 (schema)

  JSON Schema definition for the input parameters of the 'get_subtasks' tool.

  Tool(
      name="get_subtasks",
      description="Get all subtasks of a parent task",
      inputSchema={
          "type": "object",
          "properties": {
              "parent_task_id": {"type": "string", "description": "Parent task ID"},
          },
          "required": ["parent_task_id"],
      },
  ),

• src/clickup_mcp/tools.py:23-57 (registration)

  Registration of the 'get_subtasks' handler method in the tools dispatch dictionary used by call_tool.

  self._tools: Dict[str, Callable] = {
      "create_task": self.create_task,
      "get_task": self.get_task,
      "update_task": self.update_task,
      "delete_task": self.delete_task,
      "list_tasks": self.list_tasks,
      "search_tasks": self.search_tasks,
      "get_subtasks": self.get_subtasks,
      "get_task_comments": self.get_task_comments,
      "create_task_comment": self.create_task_comment,
      "get_task_status": self.get_task_status,
      "update_task_status": self.update_task_status,
      "get_assignees": self.get_assignees,
      "assign_task": self.assign_task,
      "list_spaces": self.list_spaces,
      "list_folders": self.list_folders,
      "list_lists": self.list_lists,
      "find_list_by_name": self.find_list_by_name,
      # Bulk operations
      "bulk_update_tasks": self.bulk_update_tasks,
      "bulk_move_tasks": self.bulk_move_tasks,
      # Time tracking
      "get_time_tracked": self.get_time_tracked,
      "log_time": self.log_time,
      # Templates
      "create_task_from_template": self.create_task_from_template,
      "create_task_chain": self.create_task_chain,
      # Analytics
      "get_team_workload": self.get_team_workload,
      "get_task_analytics": self.get_task_analytics,
      # User management
      "list_users": self.list_users,
      "get_current_user": self.get_current_user,
      "find_user_by_name": self.find_user_by_name,
  }

• src/clickup_mcp/client.py:438-462 (helper)

  Helper method in ClickUpClient that performs the actual API call to retrieve subtasks using the team/task endpoint with parent filter.

  async def get_subtasks(self, parent_task_id: str) -> List[Task]:
      """Get subtasks of a parent task using team endpoint."""
      # Get the workspace ID - use configured default or fetch from API
      workspace_id = self.config.default_workspace_id
      if not workspace_id:
          workspaces = await self.get_workspaces()
          if not workspaces:
              return []
          workspace_id = workspaces[0].id
  
      # Use team endpoint to get tasks with parent filter
      params = {
          "parent": parent_task_id,
          "include_closed": "true",
      }
  
      try:
          data = await self._request("GET", f"/team/{workspace_id}/task", params=params)
          tasks_data = data.get("tasks", [])
          return [Task(**task_data) for task_data in tasks_data]
      except ClickUpAPIError as e:
          # If team endpoint fails, fallback to original method
          logger.warning(f"Team endpoint failed for subtasks: {e}")
          return []