/microsoft-365-drive | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
microsoft-365-drive_copy_drive_item | Copy a drive item |
microsoft-365-drive_create_drive_folder | Create a new folder |
microsoft-365-drive_create_drive_item_share_link | Create a sharing link for a drive item |
microsoft-365-drive_delete_item | Delete a drive item |
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. |
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. |
microsoft-365-drive_get_item | Get a drive item |
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. |
microsoft-365-drive_get_my_drive | Get my OneDrive |
microsoft-365-drive_get_shared_items | List items (files and folders) that other people have shared with the signed-in user. |
microsoft-365-drive_list_drive_item_children | List contents of a folder |
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. |
microsoft-365-drive_list_my_drive_root_items | List files and folders in OneDrive root |
microsoft-365-drive_search_my_drive | Search OneDrive |
microsoft-365-drive_update_drive_item | Rename or move a drive 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. |
microsoft-365-drive_copy_drive_item
Copy a drive item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the drive item to copy |
name | string | No | — | New name for the copied item (optional — defaults to original name) |
parentReference | object | No | — | Destination folder for the copy (optional — defaults to same folder) |
microsoft-365-drive_create_drive_folder
Create a new folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the parent folder where the new folder will be created |
@microsoft.graph.conflictBehavior | string | No | — | Conflict resolution behavior if name already exists |
folder | object | Yes | — | Indicates this is a folder (use empty object {}) |
name | string | Yes | — | Name for the new folder |
microsoft-365-drive_create_drive_item_share_link
Create a sharing link for a drive item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the drive item to share |
expirationDateTime | string | No | — | Optional expiration time for the link |
scope | string | Yes | — | Scope of the sharing link |
type | string | Yes | — | Type of sharing link to create |
microsoft-365-drive_delete_item
Delete a drive item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The 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 signedurl 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:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the drive item (file) to download. |
extract_text | boolean | No | — | Whether 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
extension | string | Yes | — | File extension to match, with or without a leading dot (e.g. “pdf” or “.pdf”). |
folder_path | string | No | — | Path to the starting folder relative to the drive root. Omit or "" for the root. |
max_depth | integer | No | — | Maximum recursion depth (default 3). |
max_results | integer | No | — | Maximum number of matching files to return (default 100). |
microsoft-365-drive_get_item
Get a drive item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the drive item |
$select | string | No | — | Comma-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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | Yes | — | Path 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
$select | string | No | — | Comma-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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
$top | integer | No | — | Maximum number of items to return |
microsoft-365-drive_list_drive_item_children
List contents of a folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the folder to list |
$top | integer | No | — | Number of items to return (max 200) |
$orderby | string | No | — | Sort order (e.g. “name asc”) |
$select | string | No | — | Comma-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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_path | string | No | — | Path to the starting folder relative to the drive root, e.g. “Documents”. Omit or "" for the root. |
max_depth | integer | No | — | Maximum recursion depth (default 3). 0 lists only the immediate folder. |
max_results | integer | No | — | Maximum 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
$top | integer | No | — | Number of items to return (max 200) |
$filter | string | No | — | OData filter expression (e.g. “file ne null” for files only, “folder ne null” for folders) |
$orderby | string | No | — | Sort order (e.g. “name asc”, “lastModifiedDateTime desc”) |
$select | string | No | — | Comma-separated properties to return (e.g. “id,name,size,webUrl,lastModifiedDateTime”) |
microsoft-365-drive_search_my_drive
Search OneDrive Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
search_text | string | Yes | — | Search query string (e.g. “budget”, “presentation”, “2024”) |
$top | integer | No | — | Maximum number of results to return |
$select | string | No | — | Comma-separated properties to return |
microsoft-365-drive_update_drive_item
Rename or move a drive item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | Yes | — | The unique ID of the drive item to update |
name | string | No | — | New name for the item (to rename) |
parentReference | object | No | — | New 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | Yes | — | Destination path in OneDrive including the filename, e.g. “report.pdf” for the root or “Documents/2024/report.pdf” for a subfolder. |
content_base64 | string | Yes | — | The file content, encoded as a base64 string. |

