Skip to main content
Server path: /microsoft-365-drive | Type: Application | PCID required: Yes

Tools

ToolDescription
microsoft-365-drive_copy_drive_itemCopy a drive item
microsoft-365-drive_create_drive_folderCreate a new folder
microsoft-365-drive_create_drive_item_share_linkCreate a sharing link for a drive item
microsoft-365-drive_delete_itemDelete a drive item
microsoft-365-drive_download_fileDownload a OneDrive file by item ID. In an agent chat it returns a downloadable file artifact (a signed url plus id/filename/mimeType); in workflow/no-chat mode it returns the file content as base64. For supported document types (PDF, DOCX, PPTX, XLSX) also returns extracted text.
microsoft-365-drive_filter_files_by_extensionFind files in OneDrive with a given file extension (e.g. “pdf”, “xlsx”), searching recursively from a starting folder up to a depth limit.
microsoft-365-drive_get_itemGet a drive item
microsoft-365-drive_get_item_by_pathGet a OneDrive item (file or folder) by its path, e.g. “Documents/report.pdf”. Useful when you know the path but not the item ID.
microsoft-365-drive_get_my_driveGet my OneDrive
microsoft-365-drive_get_shared_itemsList items (files and folders) that other people have shared with the signed-in user.
microsoft-365-drive_list_drive_item_childrenList contents of a folder
microsoft-365-drive_list_folder_contentsRecursively list the contents of a OneDrive folder (and its subfolders) up to a depth limit. Use folder_path "" or omit it to start at the drive root.
microsoft-365-drive_list_my_drive_root_itemsList files and folders in OneDrive root
microsoft-365-drive_search_my_driveSearch OneDrive
microsoft-365-drive_update_drive_itemRename or move a drive item
microsoft-365-drive_upload_fileUpload a file to OneDrive at the given path. Provide the file content as a base64-encoded string. Creates the file or replaces it if one already exists at that path.

microsoft-365-drive_copy_drive_item

Copy a drive item Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item to copy
namestringNoNew name for the copied item (optional — defaults to original name)
parentReferenceobjectNoDestination folder for the copy (optional — defaults to same folder)

microsoft-365-drive_create_drive_folder

Create a new folder Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the parent folder where the new folder will be created
@microsoft.graph.conflictBehaviorstringNoConflict resolution behavior if name already exists
folderobjectYesIndicates this is a folder (use empty object {})
namestringYesName for the new folder

Create a sharing link for a drive item Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item to share
expirationDateTimestringNoOptional expiration time for the link
scopestringYesScope of the sharing link
typestringYesType of sharing link to create

microsoft-365-drive_delete_item

Delete a drive item Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item to delete

microsoft-365-drive_download_file

Download a OneDrive file by item ID. In an agent chat it returns a downloadable file artifact (a signed url plus id/filename/mimeType); in workflow/no-chat mode it returns the file content as base64. For supported document types (PDF, DOCX, PPTX, XLSX) also returns extracted text. Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item (file) to download.
extract_textbooleanNoWhether to extract text for supported document types (default true). Set false to return only the base64 content.

microsoft-365-drive_filter_files_by_extension

Find files in OneDrive with a given file extension (e.g. “pdf”, “xlsx”), searching recursively from a starting folder up to a depth limit. Parameters:
ParameterTypeRequiredDefaultDescription
extensionstringYesFile extension to match, with or without a leading dot (e.g. “pdf” or “.pdf”).
folder_pathstringNoPath to the starting folder relative to the drive root. Omit or "" for the root.
max_depthintegerNoMaximum recursion depth (default 3).
max_resultsintegerNoMaximum number of matching files to return (default 100).

microsoft-365-drive_get_item

Get a drive item Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item
$selectstringNoComma-separated properties to return

microsoft-365-drive_get_item_by_path

Get a OneDrive item (file or folder) by its path, e.g. “Documents/report.pdf”. Useful when you know the path but not the item ID. Parameters:
ParameterTypeRequiredDefaultDescription
pathstringYesPath to the item relative to the drive root, e.g. “Documents/report.pdf” or “Photos”.

microsoft-365-drive_get_my_drive

Get my OneDrive Parameters:
ParameterTypeRequiredDefaultDescription
$selectstringNoComma-separated list of properties to return (e.g. “id,name,quota,driveType”)

microsoft-365-drive_get_shared_items

List items (files and folders) that other people have shared with the signed-in user. Parameters:
ParameterTypeRequiredDefaultDescription
$topintegerNoMaximum number of items to return

microsoft-365-drive_list_drive_item_children

List contents of a folder Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the folder to list
$topintegerNoNumber of items to return (max 200)
$orderbystringNoSort order (e.g. “name asc”)
$selectstringNoComma-separated properties to return

microsoft-365-drive_list_folder_contents

Recursively list the contents of a OneDrive folder (and its subfolders) up to a depth limit. Use folder_path "" or omit it to start at the drive root. Parameters:
ParameterTypeRequiredDefaultDescription
folder_pathstringNoPath to the starting folder relative to the drive root, e.g. “Documents”. Omit or "" for the root.
max_depthintegerNoMaximum recursion depth (default 3). 0 lists only the immediate folder.
max_resultsintegerNoMaximum number of items to return across all levels (default 200).

microsoft-365-drive_list_my_drive_root_items

List files and folders in OneDrive root Parameters:
ParameterTypeRequiredDefaultDescription
$topintegerNoNumber of items to return (max 200)
$filterstringNoOData filter expression (e.g. “file ne null” for files only, “folder ne null” for folders)
$orderbystringNoSort order (e.g. “name asc”, “lastModifiedDateTime desc”)
$selectstringNoComma-separated properties to return (e.g. “id,name,size,webUrl,lastModifiedDateTime”)

microsoft-365-drive_search_my_drive

Search OneDrive Parameters:
ParameterTypeRequiredDefaultDescription
search_textstringYesSearch query string (e.g. “budget”, “presentation”, “2024”)
$topintegerNoMaximum number of results to return
$selectstringNoComma-separated properties to return

microsoft-365-drive_update_drive_item

Rename or move a drive item Parameters:
ParameterTypeRequiredDefaultDescription
item_idstringYesThe unique ID of the drive item to update
namestringNoNew name for the item (to rename)
parentReferenceobjectNoNew parent folder reference (to move the item)

microsoft-365-drive_upload_file

Upload a file to OneDrive at the given path. Provide the file content as a base64-encoded string. Creates the file or replaces it if one already exists at that path. Parameters:
ParameterTypeRequiredDefaultDescription
pathstringYesDestination path in OneDrive including the filename, e.g. “report.pdf” for the root or “Documents/2024/report.pdf” for a subfolder.
content_base64stringYesThe file content, encoded as a base64 string.