Work IQ OneDrive reference (preview)

Overview

Available tools

getOnedrive

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

No parameters required.

getFolderChildrenInMyOnedrive

Enumerates 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 will be listed (default: 'root')

findFileOrFolderInMyOnedrive

Finds a file or folder (DriveItem) in the user's OneDrive by search query. 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

Get 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

Get metadata of a file or folder (DriveItem) from a sharing URL. Only users with existing explicit permissions to access the file will be allowed to get the metadata.

Required parameters:

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

readSmallTextFileFromMyOnedrive

Read (download) a text file from the user's OneDrive.

Required parameters:

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

createSmallTextFileInMyOnedrive

Create or upload a text file of size less than 5MB 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

Create 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, a numeric suffix is added (for example, NewFolder (1)).

Required parameters:

• folderName: Name of the folder to create

Optional parameters:

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

renameFileOrFolderInMyOnedrive

Rename 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

Delete 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/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

Set 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

Create a binary file of size less than 5MB 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

Read a binary file of size less than 5MB from the user's OneDrive. File content is returned as a base64-encoded string.

Required parameters:

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

copyFileOrFolderInMyOnedrive

Copy 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

Move 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

Check the status of an asynchronous operation (such as copy or move) 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

• Get OneDrive information (quota, 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 (≤5MB)
• Read text and binary files (≤5MB)
• 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
• Multiple assignment methods (standard, privileged, auto)
• Audit justification support
• Concurrency control with eTags

Notes

• All operations target the authenticated user's personal OneDrive
• File operations are limited to ≤5MB 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 maximum 20 items by default