Work IQ OneDrive reference (preview)

Overview

Available tools

getOnedrive

Gets information about the user's OneDrive, including drive metadata, quota, and owner information.

No parameters required.

getFolderChildrenInMyOnedrive

Enumerates the top 20 files and folders (DriveItems) contained within a specified parent folder in the user's OneDrive.

Optional parameters:

• parentFolderId: ID of the parent folder whose files and folders you want to list (default: 'root')

findFileOrFolderInMyOnedrive

Finds a file or folder (DriveItem) in the user's OneDrive by search query. This method is more efficient than searching all accessible files if you know the item is in the user's OneDrive.

Required parameters:

• searchQuery: Search query; can be the entire or partial file name

getFileOrFolderMetadataInMyOnedrive

Gets metadata of a file or folder (DriveItem) from the user's OneDrive.

Required parameters:

• fileOrFolderId: ID of the file or folder in the user's OneDrive

getFileOrFolderMetadataByUrl

Gets metadata of a file or folder (DriveItem) from a sharing URL. Only users with existing explicit permissions to access the file can get the metadata.

Required parameters:

• fileOrFolderUrl: URL of the file or folder. The URL isn't redeemed to share it with the user; they must already have explicit access.

readSmallTextFileFromMyOnedrive

Reads (downloads) a text file from the user's OneDrive.

Required parameters:

• fileId: ID of the file (DriveItem) to read or download

createSmallTextFileInMyOnedrive

Creates or uploads a text file smaller than 5 MB to the user's OneDrive.

Required parameters:

• filename: Name of the file to create
• contentText: Text content of the file

Optional parameters:

• parentFolderId: ID of the parent folder (default: 'root')

createFolderInMyOnedrive

Creates a new folder (DriveItem) in the user's OneDrive as a child of the specified parent folder. If a folder with the same name already exists, the method adds a numeric suffix (for example, NewFolder (1)).

Required parameters:

• folderName: Name of the folder to create

Optional parameters:

• parentFolderId: ID of the parent folder (default: 'root')

renameFileOrFolderInMyOnedrive

Renames a file or folder (DriveItem) in the user's OneDrive. The new name must comply with naming conventions.

Required parameters:

• fileOrFolderId: ID of the file or folder to rename
• newFileOrFolderName: The new name for the file or folder

Optional parameters:

• etag: ETag value for concurrency control. Operation succeeds only if the DriveItem's current ETag matches

deleteFileOrFolderInMyOnedrive

Deletes a file or folder (DriveItem) from the user's OneDrive.

Required parameters:

• fileOrFolderId: ID of the file or folder to delete

Optional parameters:

• etag: ETag value for concurrency control

shareFileOrFolderInMyOnedrive

Sends a sharing invitation to grant read or write permissions on a file or folder (DriveItem) in the user's OneDrive.

Required parameters:

• fileOrFolderId: ID of the file or folder to share
• recipientEmails: Array of email addresses of recipients to invite
• roles: Array of roles to assign. Accepted values: 'read', 'write' (write grants both read and write)

Optional parameters:

• message: Custom message to include in the invitation email. Default: 'Here's the file we're collaborating on.'
• sendInvitation: Whether to send a sharing invitation. Default: true.

setSensitivityLabelOnFileInMyOnedrive

Sets the sensitivity label of a file in the user's OneDrive.

Required parameters:

• fileId: ID of the file (DriveItem)
• sensitivityLabelId: ID of the sensitivity label to assign, or empty string to remove

Optional parameters:

• assignmentMethod: Assignment method: 'standard', 'privileged', 'auto', or 'unknownFutureValue' (default: 'privileged')
• justificationText: Justification text for audit purposes; required when downgrading or removing a label (default: 'Changed by MCPServer')

createSmallBinaryFileInMyOnedrive

Creates a binary file of size less than 5 MB by base64-encoding its content to the user's OneDrive.

Required parameters:

• filename: Name of the file to create including the file extension
• base64Content: The binary file content encoded as a base64 string

Optional parameters:

• parentFolderId: ID of the parent folder (default: 'root')

readSmallBinaryFileFromMyOnedrive

Reads a binary file smaller than 5 MB from the user's OneDrive. Returns the file content as a base64-encoded string.

Required parameters:

• fileId: ID of the file (DriveItem) to read or download

copyFileOrFolderInMyOnedrive

Copies a file or folder (DriveItem) to a destination folder within the user's OneDrive. This operation is asynchronous. Use checkOperationStatusInMyOnedrive to monitor progress.

Required parameters:

• sourcefileid: ID of the source file or folder (DriveItem) to copy
• destfolderid: ID of the destination folder (must exist in the user's OneDrive)

Optional parameters:

• newfilename: New name for the copied item (defaults to the original name)

moveFileOrFolderInMyOnedrive

Moves a file or folder (DriveItem) to a destination folder within the user's OneDrive. This operation is asynchronous. Use checkOperationStatusInMyOnedrive to monitor progress.

Required parameters:

• sourcefileid: ID of the source file or folder (DriveItem) to move
• destfolderid: ID of the destination folder (must exist in the user's OneDrive)

Optional parameters:

• newfilename: New name for the moved item (defaults to the original name)

checkOperationStatusInMyOnedrive

Checks the status of an asynchronous operation, such as copy or move, by using the operation token returned from the original operation. Returns progress information if still in progress, error details if failed, or the final file or folder metadata if completed successfully.

Required parameters:

• operationToken: The operation token returned from an asynchronous operation like copyFileOrFolderInMyOnedrive or moveFileOrFolderInMyOnedrive

Key features

OneDrive management

• Gets OneDrive information, such as quota and owner
• Access user's personal OneDrive
• All operations target authenticated user's OneDrive

File search and discovery

• Search files and folders by name within user's OneDrive
• Get file or folder metadata by ID or sharing URL
• Browse folder contents (up to 20 items)

File operations

• Create text and binary files (≤5 MB)
• Read text and binary files (≤5 MB)
• Delete files with concurrency control
• Rename files with eTag protection
• Copy and move files and folders asynchronously

Folder management

• Create folders with optional parent paths
• Automatic numeric suffix for duplicate folder names
• List folder contents (up to 20 items)
• Get folder metadata
• Delete folders with concurrency control
• Rename folders with eTag protection

Sharing and permissions

• Share files and folders with users
• Role-based access control (read, write)
• Email notifications for sharing
• Custom messages in invitations

Security and compliance

• Apply and remove sensitivity labels.
• Use multiple assignment methods, including standard, privileged, and auto.
• Support audit justification.
• Use concurrency control with eTags.

Notes

• All operations target the authenticated user's personal OneDrive.
• File operations are limited to files that are 5 MB or less for upload and download.
• Delete and rename operations support eTags for concurrency control.
• Sharing requires valid email addresses and appropriate permissions.
• Sensitivity labels require proper licensing and configuration.
• Folder listing returns a maximum of 20 items by default.