Skip to main content

​
What can you do with it?

OneDrive enables you to manage your cloud files and folders programmatically. You can list files and folders in any directory, search for specific files across your entire drive, upload new files or create folders, download files for viewing or processing, move and copy files between locations, share files with others through links or invitations, and access special folders like Desktop or Documents. This integration is perfect for file backup automation, document management workflows, content synchronization, and building applications that interact with cloud storage.

​
How to use it?

​
Basic Command Structure

/your-OneDrive-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform with OneDrive
  • pc-connection-id - Your PinkConnect OneDrive connection ID

​
Tools

​
List Items

List files and folders in a directory Parameters:
  • folder-path (optional) - Path to the folder (default: root)
Example: 
/your-OneDrive-connection
action: list-items
pc-connection-id: your-connection-id
folder-path: /Documents/Projects
Response: 
{
  "value": [
    {
      "id": "item-123",
      "name": "Q1 Report.docx",
      "size": 524288,
      "file": {
        "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
      },
      "lastModifiedDateTime": "2024-03-15T10:30:00Z",
      "webUrl": "https://onedrive.live.com/..."
    },
    {
      "id": "folder-456",
      "name": "Images",
      "folder": {
        "childCount": 15
      }
    }
  ]
}

​
Search Items

Search for files and folders by name Parameters:
  • search-query (required) - Search term for file or folder names
Example: 
/your-OneDrive-connection
action: search-items
pc-connection-id: your-connection-id
search-query: budget spreadsheet
Response: 
{
  "value": [
    {
      "id": "item-789",
      "name": "2024 Budget Spreadsheet.xlsx",
      "size": 1048576,
      "file": {
        "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
      },
      "parentReference": {
        "path": "/drive/root:/Finance"
      }
    }
  ]
}

​
Upload File

Upload a new file to OneDrive Parameters:
  • file-path (required) - Destination path including filename
  • content (required) - File content to upload
Example: 
/your-OneDrive-connection
action: upload-file
pc-connection-id: your-connection-id
file-path: /Documents/report.pdf
content: [binary content]
Response: 
{
  "id": "new-item-123",
  "name": "report.pdf",
  "size": 2097152,
  "file": {
    "mimeType": "application/pdf"
  },
  "createdDateTime": "2024-03-20T14:00:00Z",
  "webUrl": "https://onedrive.live.com/..."
}

​
Download File

Download a file from OneDrive Parameters:
  • item-id (required) - The ID of the file to download
Example: 
/your-OneDrive-connection
action: download-file
pc-connection-id: your-connection-id
item-id: item-123
Response: 
{
  "filename": "Q1 Report.docx",
  "content": "[binary content]",
  "type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "size": 524288
}

​
Create Folder

Create a new folder in OneDrive Parameters:
  • parent-path (required) - Parent folder path
  • folder-name (required) - Name for the new folder
Example: 
/your-OneDrive-connection
action: create-folder
pc-connection-id: your-connection-id
parent-path: /Documents
folder-name: 2024 Projects
Response: 
{
  "id": "new-folder-789",
  "name": "2024 Projects",
  "folder": {
    "childCount": 0
  },
  "createdDateTime": "2024-03-20T15:00:00Z",
  "webUrl": "https://onedrive.live.com/..."
}

​
Move Item

Move a file or folder to a new location Parameters:
  • item-id (required) - The ID of the item to move
  • destination-folder-id (required) - The ID of the destination folder
Example: 
/your-OneDrive-connection
action: move-item
pc-connection-id: your-connection-id
item-id: item-123
destination-folder-id: folder-456
Response: 
{
  "id": "item-123",
  "name": "Q1 Report.docx",
  "parentReference": {
    "id": "folder-456",
    "path": "/drive/root:/Documents/Archive"
  }
}
Generate a shareable link for a file Parameters:
  • item-id (required) - The ID of the file to share
  • link-type (optional) - Type of link: view or edit (default: view)
  • scope (optional) - Link scope: anonymous or organization (default: anonymous)
Example: 
/your-OneDrive-connection
action: create-share-link
pc-connection-id: your-connection-id
item-id: item-123
link-type: view
scope: anonymous
Response: 
{
  "id": "share-link-456",
  "link": {
    "type": "view",
    "scope": "anonymous",
    "webUrl": "https://1drv.ms/w/s/..."
  },
  "hasPassword": false
}

​
Get Recent Files

Retrieve recently accessed files Parameters: None required Example: 
/your-OneDrive-connection
action: get-recent-files
pc-connection-id: your-connection-id
Response: 
{
  "value": [
    {
      "id": "item-recent-1",
      "name": "Meeting Notes.docx",
      "lastAccessedDateTime": "2024-03-20T10:00:00Z",
      "file": {
        "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
      }
    }
  ]
}

​
Get Shared Files

List files shared with you Parameters: None required Example: 
/your-OneDrive-connection
action: get-shared-files
pc-connection-id: your-connection-id
Response: 
{
  "value": [
    {
      "id": "shared-item-1",
      "name": "Team Budget.xlsx",
      "sharedBy": {
        "user": {
          "displayName": "John Doe",
          "email": "john@company.com"
        }
      },
      "sharedDateTime": "2024-03-15T08:00:00Z"
    }
  ]
}

​
Notes

OneDrive uses MCP (Model Context Protocol) tools for most operations. A PinkConnect connection ID is required for all operations. Files have a .file property with mimeType, while folders have a .folder property with childCount. Special folders like Desktop, Documents, and Photos can be accessed through specific endpoints. For Excel files, the content is already decoded and ready to save as .xlsx - CSV conversion requires saving the file first.
⌘I