onedrive

File storage and sharing

Server path: /onedrive | Type: Application | PCID required: Yes

Tools

Tool	Description
onedrive_copy_item	Copy a file or folder to a new location in OneDrive
onedrive_create_file	Create a new file in OneDrive
onedrive_create_folder	Create a new folder in OneDrive
onedrive_create_sharing_link	Create a sharing link for a file or folder in OneDrive
onedrive_delete_item	Delete a file or folder in OneDrive
onedrive_download_file	Download a file from OneDrive and store it as an artifact. Returns a link to the stored file, metadata, and a text preview for supported types (PDF, DOCX, XLSX, PPTX). NEVER use this tool for files that are supported by the microsoft excel, powerpoint, and word tools.
onedrive_extract_msg_files	Extract and parse .msg files from a OneDrive folder
onedrive_filter_files_by_extension	Filter files by extension in a folder and its subfolders
onedrive_get_item	Get details about a specific file or folder by ID in OneDrive
onedrive_get_item_by_path	Get details about a specific file or folder by path in OneDrive
onedrive_get_shared_items	Get items shared with you in OneDrive
onedrive_list_folder_contents	List folder contents recursively or get file details
onedrive_list_items	List files and folders in OneDrive
onedrive_move_item	Move a file or folder to a new location in OneDrive
onedrive_rename_item	Rename a file or folder in OneDrive
onedrive_search_items	Search for files and folders in OneDrive. Two search modes: (1) FUZZY SEARCH (default): Full-text search across filenames and content. Without folderId, searches recursively through entire OneDrive. With folderId, only returns direct children of that folder (not recursive into subfolders). (2) EXACT MATCH: Find files with an exact filename, only searches direct children of the folder (not recursive). NOTE: Fuzzy search may not find recently uploaded files for several minutes due to OneDrive indexing delays. Use exact match with folderId for immediate results, or use onedrive_list_children.
onedrive_upload_file	Upload a file to OneDrive. Provide either fileUrl (to upload from a URL) or fileContent (base64 encoded content), but not both. NOTE: Newly uploaded files may not appear in search results for several minutes due to OneDrive indexing delays. Use onedrive_list_children or onedrive_get_item_by_path for immediate access.

---

onedrive_copy_item

Copy a file or folder to a new location in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to copy
destinationPath	string	Yes	—	Path to the destination folder
newName	string	No	—	New name of the copied file or folder

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to copy"
    },
    "destinationPath": {
      "type": "string",
      "description": "Path to the destination folder"
    },
    "newName": {
      "type": "string",
      "description": "New name of the copied file or folder"
    }
  },
  "required": [
    "PCID",
    "itemId",
    "destinationPath"
  ]
}

---

onedrive_create_file

Create a new file in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
parentPath	string	Yes	—	Path to the parent folder to create the file in
fileName	string	Yes	—	Name of the file to create
content	string	No	""	Content of the file to create, default is empty

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "parentPath": {
      "type": "string",
      "description": "Path to the parent folder to create the file in"
    },
    "fileName": {
      "type": "string",
      "description": "Name of the file to create"
    },
    "content": {
      "type": "string",
      "default": "",
      "description": "Content of the file to create, default is empty"
    }
  },
  "required": [
    "PCID",
    "parentPath",
    "fileName"
  ]
}

---

onedrive_create_folder

Create a new folder in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
parentPath	string	No	—	Path to the parent folder to create the folder in, default is root
folderName	string	Yes	—	Name of the folder to create

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "parentPath": {
      "type": "string",
      "description": "Path to the parent folder to create the folder in, default is root"
    },
    "folderName": {
      "type": "string",
      "description": "Name of the folder to create"
    }
  },
  "required": [
    "PCID",
    "folderName"
  ]
}

---

onedrive_create_sharing_link

Create a sharing link for a file or folder in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to create a sharing link for
type	string	No	"view"	Type of sharing link to create

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to create a sharing link for"
    },
    "type": {
      "type": "string",
      "default": "view",
      "description": "Type of sharing link to create"
    }
  },
  "required": [
    "PCID",
    "itemId"
  ]
}

---

onedrive_delete_item

Delete a file or folder in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to delete

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to delete"
    }
  },
  "required": [
    "PCID",
    "itemId"
  ]
}

---

onedrive_download_file

Download a file from OneDrive and store it as an artifact. Returns a link to the stored file, metadata, and a text preview for supported types (PDF, DOCX, XLSX, PPTX). NEVER use this tool for files that are supported by the microsoft excel, powerpoint, and word tools.

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file to download
stream	boolean	No	true	RECOMMENDED: true (default). Returns a downloadUrl + auth headers for efficient streaming. Set to false ONLY for small files (<2MB) requiring immediate base64 content. Setting to false for large files will blow out the context window.
extractText	boolean	No	true	Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files do not need extraction. Set to false to skip extraction.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file to download"
    },
    "stream": {
      "type": "boolean",
      "default": true,
      "description": "RECOMMENDED: true (default). Returns a downloadUrl + auth headers for efficient streaming. Set to false ONLY for small files (<2MB) requiring immediate base64 content. Setting to false for large files will blow out the context window."
    },
    "extractText": {
      "type": "boolean",
      "default": true,
      "description": "Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files do not need extraction. Set to false to skip extraction."
    }
  },
  "required": [
    "PCID",
    "itemId"
  ]
}

---

onedrive_extract_msg_files

Extract and parse .msg files from a OneDrive folder

Parameters:

Parameter	Type	Required	Default	Description
folderPath	string	Yes	—	Path to the folder containing .msg files
includeAttachments	boolean	No	false	Include attachments in the response, default is false, if true, the response will include the attachments
maxResults	number	No	100	Maximum number of .msg files to process

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "folderPath": {
      "type": "string",
      "description": "Path to the folder containing .msg files"
    },
    "includeAttachments": {
      "type": "boolean",
      "default": false,
      "description": "Include attachments in the response, default is false, if true, the response will include the attachments"
    },
    "maxResults": {
      "type": "number",
      "default": 100,
      "description": "Maximum number of .msg files to process"
    }
  },
  "required": [
    "PCID",
    "folderPath"
  ]
}

---

onedrive_filter_files_by_extension

Filter files by extension in a folder and its subfolders

Parameters:

Parameter	Type	Required	Default	Description
folderPath	string	Yes	—	Path to the folder to search in. Empty string means root
extension	string	No	".msg"	File extension to filter by (e.g., “.pdf”, “.docx”)
maxDepth	number	No	3	Maximum depth for recursive folder search, defaults to 3
maxResults	number	No	100	Maximum number of results to return, defaults to 100

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "folderPath": {
      "type": "string",
      "description": "Path to the folder to search in. Empty string means root"
    },
    "extension": {
      "type": "string",
      "default": ".msg",
      "description": "File extension to filter by (e.g., \".pdf\", \".docx\")"
    },
    "maxDepth": {
      "type": "number",
      "default": 3,
      "description": "Maximum depth for recursive folder search, defaults to 3"
    },
    "maxResults": {
      "type": "number",
      "default": 100,
      "description": "Maximum number of results to return, defaults to 100"
    }
  },
  "required": [
    "PCID",
    "folderPath"
  ]
}

---

onedrive_get_item

Get details about a specific file or folder by ID in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to get

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to get"
    }
  },
  "required": [
    "PCID",
    "itemId"
  ]
}

---

onedrive_get_item_by_path

Get details about a specific file or folder by path in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
path	string	Yes	—	Path to the file or folder to get

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "path": {
      "type": "string",
      "description": "Path to the file or folder to get"
    }
  },
  "required": [
    "PCID",
    "path"
  ]
}

---

onedrive_get_shared_items

Get items shared with you in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
pageSize	number	No	25	Number of items to list

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "pageSize": {
      "type": "number",
      "default": 25,
      "description": "Number of items to list"
    }
  },
  "required": [
    "PCID"
  ]
}

---

onedrive_list_folder_contents

List folder contents recursively or get file details

Parameters:

Parameter	Type	Required	Default	Description
path	string	No	—	Path to the folder or file to list, defaults to root if not provided
maxDepth	number	No	3	Maximum depth for recursive folder listing, defaults to 3

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "path": {
      "type": "string",
      "description": "Path to the folder or file to list, defaults to root if not provided"
    },
    "maxDepth": {
      "type": "number",
      "default": 3,
      "description": "Maximum depth for recursive folder listing, defaults to 3"
    }
  },
  "required": [
    "PCID"
  ]
}

---

onedrive_list_items

List files and folders in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
path	string	No	""	Path to the folder to list, default is root
pageSize	number	No	25	Number of items to list, default is 25

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "path": {
      "type": "string",
      "default": "",
      "description": "Path to the folder to list, default is root"
    },
    "pageSize": {
      "type": "number",
      "default": 25,
      "description": "Number of items to list, default is 25"
    }
  },
  "required": [
    "PCID"
  ]
}

---

onedrive_move_item

Move a file or folder to a new location in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to move
destinationPath	string	Yes	—	Path to the destination folder
newName	string	No	—	New name of the moved file or folder

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to move"
    },
    "destinationPath": {
      "type": "string",
      "description": "Path to the destination folder"
    },
    "newName": {
      "type": "string",
      "description": "New name of the moved file or folder"
    }
  },
  "required": [
    "PCID",
    "itemId",
    "destinationPath"
  ]
}

---

onedrive_rename_item

Rename a file or folder in OneDrive

Parameters:

Parameter	Type	Required	Default	Description
itemId	string	Yes	—	ID of the file or folder to rename
newName	string	Yes	—	New name of the file or folder

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "itemId": {
      "type": "string",
      "description": "ID of the file or folder to rename"
    },
    "newName": {
      "type": "string",
      "description": "New name of the file or folder"
    }
  },
  "required": [
    "PCID",
    "itemId",
    "newName"
  ]
}

---

onedrive_search_items

Search for files and folders in OneDrive. Two search modes: (1) FUZZY SEARCH (default): Full-text search across filenames and content. Without folderId, searches recursively through entire OneDrive. With folderId, only returns direct children of that folder (not recursive into subfolders). (2) EXACT MATCH: Find files with an exact filename, only searches direct children of the folder (not recursive). NOTE: Fuzzy search may not find recently uploaded files for several minutes due to OneDrive indexing delays. Use exact match with folderId for immediate results, or use onedrive_list_children.

Parameters:

Parameter	Type	Required	Default	Description
query	string	Yes	—	Search query - for fuzzy search this matches filenames and content; for exact match this must be the exact filename
folderId	string	No	—	Folder ID to limit search to. IMPORTANT: Only returns direct children of this folder (not recursive into subfolders). If not provided, fuzzy search is recursive through entire OneDrive. Get folder IDs from onedrive_list_items or onedrive_list_children.
exactMatch	boolean	No	false	If true, find files with exact filename match (direct children only, not recursive). If false (default), performs fuzzy full-text search.
pageSize	number	No	25	Number of items to return, default is 25

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "query": {
      "type": "string",
      "description": "Search query - for fuzzy search this matches filenames and content; for exact match this must be the exact filename"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID to limit search to. IMPORTANT: Only returns direct children of this folder (not recursive into subfolders). If not provided, fuzzy search is recursive through entire OneDrive. Get folder IDs from onedrive_list_items or onedrive_list_children."
    },
    "exactMatch": {
      "type": "boolean",
      "default": false,
      "description": "If true, find files with exact filename match (direct children only, not recursive). If false (default), performs fuzzy full-text search."
    },
    "pageSize": {
      "type": "number",
      "default": 25,
      "description": "Number of items to return, default is 25"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

---

onedrive_upload_file

Upload a file to OneDrive. Provide either fileUrl (to upload from a URL) or fileContent (base64 encoded content), but not both. NOTE: Newly uploaded files may not appear in search results for several minutes due to OneDrive indexing delays. Use onedrive_list_children or onedrive_get_item_by_path for immediate access.

Parameters:

Parameter	Type	Required	Default	Description
parentPath	string	Yes	—	Path to the parent folder to upload the file to
fileName	string	Yes	—	Name of the file to upload
fileContent	string	No	—	Base64 encoded content of the file to upload. Required if fileUrl is not provided.
fileUrl	string	No	—	URL of the file to upload. Required if fileContent is not provided.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "parentPath": {
      "type": "string",
      "description": "Path to the parent folder to upload the file to"
    },
    "fileName": {
      "type": "string",
      "description": "Name of the file to upload"
    },
    "fileContent": {
      "type": "string",
      "description": "Base64 encoded content of the file to upload. Required if fileUrl is not provided."
    },
    "fileUrl": {
      "type": "string",
      "description": "URL of the file to upload. Required if fileContent is not provided."
    }
  },
  "required": [
    "PCID",
    "parentPath",
    "fileName"
  ]
}