# OneDrive

The Microsoft Graph OneDrive API enables access to files and folders stored in OneDrive. This integration allows reading, managing, and searching OneDrive content on behalf of the user.

- Category: Productivity
- Connection: Sign in. Sign in with your OneDrive account. No API key to copy.
- Plans: Free: Not included; MCP only ($9/mo): 2,000 calls a month; Pro: 20,000 calls a month; Max: 20,000 calls a month
- Status: coming soon

## Tools

- Get download link (`MICROSOFT_ONEDRIVE__GET_DOWNLOAD_LINK`): Get the download URL for a driveItem file. Returns the @microsoft.graph.downloadUrl property which provides a preauthenticated download URL that's valid for a short period. This URL can be used directly for downloading without additional authentication.
- Get drive (`MICROSOFT_ONEDRIVE__GET_DRIVE`): Retrieve the properties and relationships of a specific Drive resource by its ID. A Drive is the top-level container for a file system, such as OneDrive or SharePoint document libraries.
- Get drive item by id (`MICROSOFT_ONEDRIVE__GET_DRIVE_ITEM_BY_ID`): Retrieve the metadata for a driveItem in a drive by its unique ID. Returns file/folder details including name, size, created/modified dates, parent references, and other properties.
- Get drive item by path (`MICROSOFT_ONEDRIVE__GET_DRIVE_ITEM_BY_PATH`): Retrieve the metadata for a driveItem in a drive by its file system path relative to the root. Returns file/folder details including name, size, created/modified dates, and other properties. Use this when you know the path but not the item ID.
- Get my drive (`MICROSOFT_ONEDRIVE__GET_MY_DRIVE`): Get the current user's OneDrive. The signed-in user's drive is accessed automatically and will be provisioned if it doesn't exist but the user has a license to use OneDrive.
- Get root folder (`MICROSOFT_ONEDRIVE__GET_ROOT_FOLDER`): Get the root folder of the user's OneDrive. This is a shortcut to access the top-level folder without needing to know its ID. Supports expanding children and other OData query parameters.
- Create excel from csv (`MICROSOFT_ONEDRIVE__CREATE_EXCEL_FROM_CSV`): Convert CSV data to a formatted text file and save it to OneDrive. Takes CSV data as a string and creates a properly formatted CSV file in the specified parent folder on OneDrive. While named 'excel', this creates a CSV file that can be opened in Excel.
- Create folder (`MICROSOFT_ONEDRIVE__CREATE_FOLDER`): Create a new folder in a drive at the specified parent location. Returns the newly created folder with its metadata including ID, name, creation time, and parent reference. Supports conflict resolution when a folder with the same name already exists.
- Create text file (`MICROSOFT_ONEDRIVE__CREATE_TEXT_FILE`): Upload or create a new text-based file to OneDrive. This method only supports text-based files like .txt, .md, .csv, .json, .log, .xml, .html, .css, .js, .py, .yaml, etc. Files up to 250 MB in size are supported. The file will be created at the specified parent location with the given filename.
- List drive item children (`MICROSOFT_ONEDRIVE__LIST_DRIVE_ITEM_CHILDREN`): Return a collection of DriveItems in the children relationship of a DriveItem. DriveItems with a non-null folder or package facet can have one or more child DriveItems.
- List drive item versions (`MICROSOFT_ONEDRIVE__LIST_DRIVE_ITEM_VERSIONS`): Retrieve the version history of a driveItem. OneDrive and SharePoint retain file history depending on configuration. Returns DriveItemVersion objects with version ID, lastModifiedBy, lastModifiedDateTime, and size. Versions are returned in descending order (newest to oldest).
- List drives (`MICROSOFT_ONEDRIVE__LIST_DRIVES`): List all drives available to the current user (personal, shared, or group drives).
- Search all accessible items (`MICROSOFT_ONEDRIVE__SEARCH_ALL_ACCESSIBLE_ITEMS`): Search more broadly to include items shared with the current user, in addition to items within the user's drive. Returns items from the user's drive and items shared with them from other drives.
- Search drive items (`MICROSOFT_ONEDRIVE__SEARCH_DRIVE_ITEMS`): Search the hierarchy of items within a drive for items matching a query. Searches across filename, metadata, and file content within the user's drive only.
- Update drive item (`MICROSOFT_ONEDRIVE__UPDATE_DRIVE_ITEM`): Update the metadata for a driveItem by ID. Allows updating properties such as name (to rename files/folders), parentReference (to move items), and other metadata. Returns the updated DriveItem resource with modified properties.
- Update text file content (`MICROSOFT_ONEDRIVE__UPDATE_TEXT_FILE_CONTENT`): Update or replace the contents of an existing text-based file in OneDrive. This method only supports text-based files like .txt, .md, .csv, .json, .log, .xml, .html, .css, .js, .py, .yaml, etc. Files up to 250 MB in size are supported. The file content will be completely replaced with the new content provided.
- Copy drive item (`MICROSOFT_ONEDRIVE__COPY_DRIVE_ITEM`): Create a copy of a driveItem asynchronously including child items. You can specify a new parent folder, provide a new name, copy only children, or include version history. The operation is queued and processed asynchronously - use the monitor URL to track progress until completion.
- Delete drive item (`MICROSOFT_ONEDRIVE__DELETE_DRIVE_ITEM`): Delete a DriveItem by using its ID. Deleting items using this method moves the items to the recycle bin instead of permanently deleting the item. Returns 204 No Content on successful deletion.
- Delta drive items (`MICROSOFT_ONEDRIVE__DELTA_DRIVE_ITEMS`): Track changes in a driveItem and its children over time. Use for incremental synchronization to detect added, modified, or deleted items. Returns @odata.nextLink for pagination or @odata.deltaLink for future change tracking.
- Move drive item (`MICROSOFT_ONEDRIVE__MOVE_DRIVE_ITEM`): Move a driveItem to a new parent folder by updating its parentReference. You can also rename the item during the move operation. This is a special case of the update method that moves items within the same drive. Items cannot be moved between different drives.
- Permanent delete drive item (`MICROSOFT_ONEDRIVE__PERMANENT_DELETE_DRIVE_ITEM`): Permanently delete a driveItem by using its ID. WARNING: Items deleted with this method are permanently removed and are NOT sent to the recycle bin. They cannot be restored afterward. Use with extreme caution. Returns 204 No Content on successful deletion.
- Read text file content (`MICROSOFT_ONEDRIVE__READ_TEXT_FILE_CONTENT`): Read the content of a text-based file from OneDrive by its item ID. This function downloads the actual file content for text-based files such as .txt, .csv, .md, .log, .json, and other text formats.

## Questions

### When can I connect OneDrive?

OneDrive is coming soon and cannot be connected yet. Browse the catalog for apps you can connect now.

### Which plan includes OneDrive?

MCP only with 2,000 calls a month, Pro and Max with 20,000. Calls are shared by every catalog app in the workspace. Past the monthly number they keep working from AI credits at $0.90 per 1,000 calls; the count resets on the 1st (UTC) and a retried call counts once.

Back to the [MCP catalog](https://krypton.bot/mcp-catalog/).