OneDrive
OneDrive is Microsoft’s cloud storage solution enabling users to store, sync, and share files across devices, offering offline access, real-time collaboration, and enterprise-grade security
Verdict
Common use cases
- Share meeting notes with external stakeholders
- Search for contract drafts by filename
- Create project folders during kickoff calls
- Download quarterly reports for analysis
- Generate public links for client deliverables
Integration
- Vendor
- OneDrive
- Category
- other
- Auth
- OAUTH2
- Tools
- 35
- Composio slug
one_drive
Tools
- Copy Item
Tool to copy a driveitem (file or folder) to a new location asynchronously. use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. the operation is asynchronous; the response provides a url t
- Create a new text file
Creates a new text file with specified content in a onedrive folder, using either the folder's unique id or its absolute path (paths are automatically resolved to ids); note that onedrive may rename or create a new version if the filename a
- Create folder
Creates a new folder in the user's onedrive, automatically renaming on conflict, optionally within a specified parent folder (by id or full path from root) which, if not the root, must exist and be accessible.
- Create Sharing Link
Tool to create a sharing link for a driveitem (file or folder) by its unique id. use when you need to generate a shareable link for an item in onedrive or sharepoint.
- Delete Itemdestructive
Tool to delete a driveitem (file or folder) by its unique id from the authenticated user's onedrive. use when you need to remove an item from onedrive. this action moves the item to the recycle bin, not permanently deleting it.
- Download a file
Downloads a file from a user's onedrive using its item id, which must refer to a file and not a folder.
- Find Folder
Finds folders by name within an accessible parent folder in onedrive, or lists all its direct child folders if no name is specified.
- Find Item
Non-recursively finds an item (file or folder) in a specified onedrive folder; if `folder` is provided as a path, it must actually exist.
- Get Drive
Retrieves the properties and relationships of a drive resource by its unique id. use this action when you need to get details about a specific onedrive, user's onedrive, group's document library, or a site's document library.
- Get Drive Quota
Tool to retrieve the quota information for the authenticated user's onedrive. use this action to check the storage space details like total, used, and remaining space on the user's onedrive.
- Get Item Metadata
Retrieves the metadata of a driveitem by its unique id. use this tool to get information about a specific file or folder in onedrive when you have its id. if a `drive id` is not provided, it defaults to the user's main drive.
- Get Item Permissions
Retrieves the permissions of a driveitem by its unique id or path within a specific drive. use when you need to check who has access to a file or folder and what level of access they have.
- Get Item Thumbnails
Tool to retrieve the thumbnails associated with a driveitem. use when you need to display visual previews of files.
- Get Item Versions
Tool to retrieve the version history of a driveitem by its unique id. use when you need to access or list previous versions of a file.
- Get Recent Items
Retrieves a list of items that have been recently used by the authenticated user. this tool is useful when you need to access or display files and folders that the user has interacted with recently across their onedrive and accessible share
- Get Shared Items
Tool to retrieve a list of items that have been shared with the authenticated user. use this action to get details of files and folders shared with the current user.
- Get SharePoint List Items
Tool to get the items (list items) within a specific sharepoint list on a site. use when you need to retrieve data from a sharepoint list.
- Get SharePoint Site Page Content
Gets the content of a modern sharepoint site page. use when you need to retrieve the details and content of a specific page within a sharepoint site.
- Get Site Details
Retrieves metadata for a specific sharepoint site by its id. use this action when you need to get details like display name, web url, and creation/modification dates for a known sharepoint site.
- Invite User to Drive Item
Tool to invite users or grant permissions to a specific item in a onedrive drive. use when you need to share a file or folder with other users and define their access level (e.g., read or write).
- List Drive Item Activities
Tool to list recent activities for a specific item in a onedrive drive. use when you need to track changes or actions performed on a file or folder.
- List Drives
Tool to retrieve a list of drive resources available to the authenticated user, or for a specific user, group, or site. use when you need to find out what drives are accessible.
- List OneDrive items
Retrieves all files and folders as `driveitem` resources from the root of a specified user's onedrive, automatically handling pagination.
- List Root Drive Changes
Tool to list changes in the root of the user's primary drive using a delta token. use when you need to track file and folder modifications, additions, or deletions in the main onedrive directory.
- List SharePoint List Items Delta
Tool to track changes to items in a sharepoint list using a delta query. use when you need to get newly created, updated, or deleted list items without performing a full read of the entire item collection.
- List Site Columns
Tool to list all column definitions for a sharepoint site. use this when you need to retrieve the schema or structure of columns within a specific sharepoint site.
- List Site Drive Items Delta
Tool to track changes to driveitems in the default document library of a sharepoint site. use when you need to get a list of items that have been added, modified, or deleted since a previous state or to get an initial enumeration of all ite
- List Site Lists
Tool to list all lists under a specific sharepoint site. use when you need to enumerate lists within a known site.
- List Site Subsites
Tool to list all subsites of a sharepoint site. use when you need to retrieve a collection of subsites for a given parent site.
- List Subscriptions
Tool to list the current subscriptions for the authenticated user or app. use this to retrieve details of existing webhook subscriptions.
- Move Item
Tool to move a file or folder to a new parent folder in onedrive. use when you need to reorganize your files or folders by changing their location. you can optionally rename the item during the move.
- Preview Drive Item
Generates or retrieves a short-lived embeddable url for a preview of a specific item. use when you need to display a temporary preview of a file.
- Search Items
Searches for driveitems in onedrive that match the specified query. use this to find files or folders based on keywords.
- Update Drive Item Metadata
Tool to update the metadata of a specific item (file or folder) in onedrive. use this to rename items, change descriptions, or move items to a new parent folder.
- Upload file
Uploads a file to a specified onedrive folder, automatically renaming on conflict and supporting large files via chunking.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add MCP' and select OneDrive from the list. 3. Click 'Connect' to start the OAuth flow — you'll be redirected to Microsoft's login page. 4. Sign in with the Microsoft account that owns the OneDrive you want to access. 5. Review the permission scopes (read and write access to your files) and click 'Accept'. 6. You'll return to Switchy with a confirmation that OneDrive is connected. 7. Open any Space and type '@OneDrive list my folders' to test the connection. 8. If you see a list of your top-level folders, the integration is live. 9. To invoke a tool, @mention OneDrive in a message and describe what you need — the AI will call the appropriate tool and return results inline.
What teammates see: by default, memories from OneDrive are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Find Recent Proposals
@OneDrive search my drive for files with 'proposal' in the name and show me the five most recent ones.Open in a Space →
Create Project Folder
@OneDrive create a new folder called 'Q2 Campaign Assets' in my Marketing folder and confirm when it's ready.Open in a Space →
Share Link for Review
@OneDrive find the file named 'Budget 2024 Final.xlsx' and create a view-only sharing link for it.Open in a Space →
Download Contract Draft
@OneDrive download the file 'Vendor Agreement - Acme Corp.docx' from my Contracts folder so we can review section three.Open in a Space →
List Folder Contents
@OneDrive list all files and folders inside my 'Client Deliverables' folder and tell me which ones were modified this week.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@OneDrive find all folders named 'Q1 Reports' in my Marketing directory and show me their last modified dates
Found 2 folders matching 'Q1 Reports' in /Marketing: 1. Q1 Reports (2024) — Last modified: March 28, 2024 at 3:42 PM. Contains 14 items. 2. Q1 Reports (Archive) — Last modified: January 15, 2024 at 9:20 AM. Contains 8 items. Both folders are accessible. The 2024 folder appears to be the active version based on recent activity. Would you like me to list the contents of either folder or create a sharing link?
This example demonstrates the Find Folder tool's search capability. The MCP requires the parent folder path to exist and only searches one level deep (non-recursive). If your OneDrive structure is deeply nested, you may need multiple queries to locate items across subdirectories.
@OneDrive create a new text file called 'meeting-notes.txt' in my Projects folder with today's standup summary, then generate a sharing link
Created meeting-notes.txt in /Projects with your standup summary (247 characters). OneDrive assigned the file ID: 01ABCDEF123456. Generated sharing link (view-only): https://1drv.ms/t/s!Ak7X... The link allows anyone with the URL to view the file without signing in. The file is now accessible to your team. Note: OneDrive may have renamed the file if 'meeting-notes.txt' already existed in that folder.
This example chains two tools: Create a new text file followed by Create Sharing Link. The write operation requires appropriate OAuth2 scopes (Files.ReadWrite). Be aware that OneDrive automatically renames files on conflict rather than overwriting, so you may end up with 'meeting-notes (1).txt' if the name exists.
@OneDrive download the latest version of 'budget-2024.xlsx' from my Finance folder, analyze the Q1 spending trends, and summarize any line items over $10k
Downloaded budget-2024.xlsx (item ID: 01XYZ789). Analyzing Q1 data from the 'Expenses' sheet... Q1 Spending Summary: - Total Q1 spend: $847,320 - 6 line items exceeded $10k threshold: • Cloud Infrastructure: $142,500 (17% of total) • Contractor Fees: $89,200 • Marketing Campaigns: $67,800 • Office Lease: $45,000 • Software Licenses: $38,100 • Travel & Events: $24,600 Cloud infrastructure represents the largest single expense. Contractor fees increased 34% vs. Q4 2023. Would you like a deeper breakdown of any category?
This example showcases the Download tool paired with AI reasoning to extract insights from file contents. The MCP retrieves the file by item ID, then the AI processes the data. You'll need Files.Read scope at minimum. This workflow is powerful for spreadsheet analysis, but large files may hit token limits during processing.
Use-case deep-dives
When OneDrive MCP beats manual file sharing for client work
A 6-person creative agency ships final assets to clients every Friday. Before OneDrive MCP, someone manually zipped folders, uploaded to a share link, and emailed the URL. Now the team runs a Switchy workflow that creates a timestamped folder, copies final files from their working directory, generates a sharing link, and posts it to the client Slack channel. The MCP's 35 tools handle edge cases like renaming on conflict and resolving folder paths automatically. This works cleanly for teams shipping under 50 deliverables per week; beyond that threshold, the async copy operations start queuing and you need a dedicated file-ops service. If your agency ships polished work to external stakeholders on a schedule, OneDrive MCP turns a 10-minute manual task into a one-click handoff.
Why small HR teams use OneDrive MCP for new-hire folders
A 3-person HR team at a 40-employee startup creates a personalized OneDrive folder for every new hire: offer letter, benefits PDF, first-week checklist. They used to copy a template folder by hand and rename files. With OneDrive MCP in Switchy, they trigger a workflow from their HRIS webhook that creates the folder structure, writes a text file with the hire's start date and manager name, and copies static docs from a master template. The create-folder and create-text-file tools handle the structure; copy-item duplicates the PDFs. This breaks down if your onboarding involves more than 20 custom files per hire, because the MCP doesn't batch operations and you'll hit rate limits. For small teams onboarding 2-5 people a month, OneDrive MCP eliminates the manual folder-prep ritual and ensures nothing gets skipped.
When OneDrive MCP isn't the right call for support workflows
A 5-person support team wanted to auto-download customer screenshots from OneDrive links pasted into Zendesk tickets, then attach them to an internal investigation folder. OneDrive MCP has a download-file tool, but it requires the item ID, not a sharing link. The team would need a separate step to resolve the link to an ID, and OneDrive's API doesn't expose that mapping cleanly. They ended up using a webhook-to-Zapier bridge instead. OneDrive MCP shines when you control the folder structure and know item IDs in advance; it's clunky for ad-hoc link-based workflows where customers share files outside your tenant. If your support process involves parsing external OneDrive links, this MCP adds friction instead of removing it.
Frequently asked
What can the OneDrive MCP do in Switchy?
It lets your AI agents create, copy, delete, download, and share files and folders in your OneDrive. Agents can search for items by name, create text files with specific content, generate sharing links, and manage folder structures. All operations run under the permissions of whoever connects their Microsoft account, so agents see exactly what that user can access in OneDrive.
Which Microsoft permissions does the OneDrive MCP need?
It uses OAuth2 to request Files.ReadWrite.All scope, which grants full read and write access to all files the authenticated user can reach. You'll authorise this through Microsoft's standard login flow. The MCP can't access files outside the connecting user's OneDrive permissions, and it can't perform admin-level tenant operations or read other users' drives unless explicitly shared.
Can the OneDrive MCP search inside file contents or only filenames?
It searches by filename only, not file contents. The Find Item and Find Folder tools match against item names within a specified parent folder, and searches are non-recursive by default. If you need full-text search across document bodies, use Microsoft Graph API directly or have agents download files first, then parse them locally in Switchy.
How does this compare to using OneDrive's web interface or API?
The MCP wraps 35 common OneDrive operations so agents can act on files without you writing API code or clicking through the web UI. It's faster for repetitive tasks like bulk file creation or generating sharing links, but it doesn't expose every Graph API feature. For advanced scenarios like versioning, metadata editing, or SharePoint site management, call the Graph API directly.
Who on my team should connect the OneDrive MCP?
Connect it with an account that has access to the files your agents need to manipulate. If agents will create files in a shared team folder, use a service account or a team member with write permissions to that folder. Each connection counts as one MCP integration under your Switchy plan, regardless of how many agents use it.