OneDrive

Microsoft-hosted Agent 365 server for files and folders in a signed-in user's personal OneDrive

Official · Microsoft Remote (hosted) · Streamable HTTP Files and storage

40 popularity score

Connect your client

Remote (hosted)

Add in one click

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal
claude mcp add --transport http onedrive 'https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer'
Claude (desktop and web)Settings → Connectors → Add custom connector
https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer
ChatGPTSettings → Apps → Advanced → Developer mode, then Create app
https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "onedrive": {
      "url": "https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer"
    }
  }
}
VS Code.vscode/mcp.json
{
  "servers": {
    "onedrive": {
      "type": "http",
      "url": "https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer"
    }
  }
}
Codex~/.codex/config.toml
[mcp_servers.onedrive]
url = "https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer"
Gemini CLITerminal
gemini mcp add --scope user --transport http onedrive 'https://agent365.svc.cloud.microsoft/agents/tenants/%7BtenantId%7D/servers/mcp_OneDriveRemoteServer'

What it does

OneDrive is one of the workload servers Microsoft runs inside Agent 365, listed under the server ID mcp_OneDriveRemoteServer at a per-tenant address on agent365.svc.cloud.microsoft. It works only on the personal OneDrive of whoever is signed in, not on SharePoint sites or other people's drives.

Its 17 tools cover the everyday file chores: reading drive details and quota, listing a folder, searching by name, reading metadata (also from a sharing link), reading and creating small text or binary files, creating, renaming, deleting, copying and moving items, sending sharing invitations with read or write rights, and setting or removing a Microsoft Purview sensitivity label. Copy and move run in the background and return a token that a separate tool polls for progress.

Microsoft marks the server as preview and, on the same reference page, calls the app-specific Microsoft 365 servers (OneDrive among them) a legacy set kept for backward compatibility; it tells new projects to use Work IQ MCP instead. A few defaults are only visible in the parameter tables: folder listings return the top 20 items, new files land in the drive root unless parentFolderId is given, and a label change without a justification is logged as 'Changed by MCPServer'.

What it needs

A Microsoft 365 work tenant with Agent 365, the OneDrive server present in the Tools registry of the Microsoft 365 admin center (availability varies by tenant, region, rollout, licensing and admin approval), the tenant ID to fill into the endpoint URL, and a Microsoft Entra sign-in of the user whose OneDrive it acts on. Sensitivity labels need the matching licence and configuration.

Limits

Preview: Microsoft says tool names and parameters may change and it is not meant for production; the app-specific servers are kept only for backward compatibility. Uploads and downloads are capped at 5 MB. Folder listing returns at most 20 items by default. Only the signed-in user's own OneDrive is reached; sharing-link metadata works only where the user already has explicit permission. Copy and move are asynchronous and need a status check.

Who it suits

Suits teams already on Microsoft 365 with Agent 365 who want an agent to tidy, read or share small files in a user's own OneDrive without running anything themselves, and who accept a preview, admin-gated service. For new builds Microsoft points to Work IQ MCP instead. For SharePoint document libraries, the SharePoint (Agent 365) server we hold covers sites and libraries; the ODSP remote server we hold is a separate Agent 365 server ID spanning OneDrive and SharePoint. Not a fit for personal Microsoft accounts or files over 5 MB.

Tools 17

getOnedrive
Returns drive details for the user's OneDrive: quota, owner and metadata
getFolderChildrenInMyOnedrive
Lists up to 20 items in a folder, the root by default
findFileOrFolderInMyOnedrive
Searches the user's OneDrive by full or partial name
getFileOrFolderMetadataInMyOnedrive
Fetches metadata for an item by its ID
getFileOrFolderMetadataByUrl
Fetches item metadata from a sharing link the user already has rights to
readSmallTextFileFromMyOnedrive
Downloads the contents of a text file
createSmallTextFileInMyOnedrive
Creates or uploads a text file under 5 MB
createFolderInMyOnedrive
Makes a new folder, adding a number if the name is taken
renameFileOrFolderInMyOnedrive
Gives an item a new name
deleteFileOrFolderInMyOnedrive
Removes a file or folder
shareFileOrFolderInMyOnedrive
Invites people by email with read or write rights to an item
setSensitivityLabelOnFileInMyOnedrive
Applies, changes or clears a sensitivity label on a file
createSmallBinaryFileInMyOnedrive
Uploads a binary file under 5 MB sent as base64
readSmallBinaryFileFromMyOnedrive
Downloads a binary file under 5 MB as base64
copyFileOrFolderInMyOnedrive
Starts a background copy of an item to another folder
moveFileOrFolderInMyOnedrive
Starts a background move of an item to another folder
checkOperationStatusInMyOnedrive
Polls the progress of a copy or move by its operation token

Similar servers