Microsoft 365 OneDrive MCP server reference

Important

You need to be part of the Frontier preview program to get early access to Microsoft Agent 365. Frontier connects you directly with Microsoft’s latest AI innovations. Frontier previews are subject to the existing preview terms of your customer agreements. As these features are still in development, their availability and capabilities may change over time.

Overview

Server ID	Display name	Description
mcp_OneDriveRemoteServer	Microsoft OneDrive MCP server	MCP server for OneDrive operations. Use this server for managing files and folders in the user's personal OneDrive. All file operations limited to ≤5MB.

Note

The Microsoft SharePoint and OneDrive MCP server is deprecated starting March 13, 2026. If it's an existing connection, it's still supported. To set up new connections, use the new Microsoft SharePoint MCP Server and the Microsoft OneDrive MCP Server.

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')

findFileOrFolderInMyDrive

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. You need to provide a fileId (driveItemId) to identify and download the file.

Required parameters:

• fileId: The driveItemId of the file 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
• 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
• etag: ETag value for concurrency control

moveSmallFileInMyOnedrive

Move a file (DriveItem) in the user's OneDrive to another folder. Only supports files less than 5MB.

Required parameters:

• fileId: ID of the file to move
• newParentFolderId: ID of the target folder (must be in the user's OneDrive)
• 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: The driveItemId of the file
• sensitivityLabelId: ID of the sensitivity label to assign, or empty string to remove it

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')

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 files (≤5MB)
• Read text files
• Delete files with concurrency control
• Rename files with eTag protection
• Move files between folders

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, rename, and move operations require eTags for concurrency control
• All operations use Microsoft Graph API
• Sharing requires valid email addresses and appropriate permissions
• Sensitivity labels require proper licensing and configuration
• Folder listing returns maximum 20 items by default
• eTag protection prevents conflicts in concurrent operations

Note

MCP tool names and parameters are subject to change and hard-coded dependencies should be avoided. Scenario support will be maintained.