
Onedrive
MCP server giving AI clients read access to OneDrive files via Microsoft Graph
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Onedrive
Onedrive is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.
The Pipeworx OneDrive pack lets an AI client browse folders, search by keyword, read file metadata and fetch the text of plain-text, Markdown or CSV documents from a Microsoft 365 OneDrive account. It also lists items shared with the user and reports storage quota and the connected owner.
The pack runs on the Pipeworx gateway, which forwards calls to the Microsoft Graph API. The README notes that tool listings from the endpoint also include shared gateway meta-tools such as ask_pipeworx, and that the pack is an independent, unofficial integration.
It suits people who want an assistant to find and read documents in their OneDrive without uploading them anywhere by hand. Binary formats such as Office files and PDFs are not readable through the text download tool, and returned content is capped at about 100,000 characters.
Install
Run in a terminal
claude mcp add --transport http onedrive https://gateway.pipeworx.io/onedrive/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/onedrive/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"onedrive": {
"url": "https://gateway.pipeworx.io/onedrive/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"onedrive": {
"type": "http",
"url": "https://gateway.pipeworx.io/onedrive/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"onedrive": {
"serverUrl": "https://gateway.pipeworx.io/onedrive/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"onedrive": {
"type": "http",
"url": "https://gateway.pipeworx.io/onedrive/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- onedrive_list_files
- List files and folders in a OneDrive folder.
- onedrive_search_files
- Search OneDrive for files and folders matching a query.
- onedrive_get_file
- Get full metadata for a single file or folder by item id.
- onedrive_get_file_content
- Download the text content of a file by item id.
- onedrive_list_shared
- List files and folders shared with the user.
- onedrive_get_profile
- Get the drive profile, storage quota and owner name.
What it does
- Folder browsing
- Lists files and folders at a given path in the OneDrive drive, or at the root by default.
- Keyword file search
- Searches file names and content across a user's OneDrive for matching items.
- Text file download
- Returns the text of plain-text, Markdown and CSV files, flagged when truncated.
- Shared item listing
- Lists files and folders shared with the user, with the name of who shared them.
- Storage and account profile
- Reports drive type, storage used and total in bytes, and the owner display name.
Good for
- Finding a document by keyword across a Microsoft 365 OneDrive
- Reading a Markdown or CSV file from OneDrive into an AI conversation
- Checking which documents colleagues have shared with you
- Reporting OneDrive storage usage for an account
Pricing
Freemium, from $49 a month
Anonymous 50 calls/day; free account 200 calls/day; paid credits and subscriptions beyond that.
Prices change. Check pipeworx.io before you buy.
Onedrive FAQ
Can it read Word, Excel or PDF files?
The download tool is best for plain-text, Markdown and CSV files. The README says binary formats such as Office documents, PDFs and images return unreadable bytes.
Does it need an API key?
The npm package works anonymously capped at 50 calls a day. A free Pipeworx account raises the cap to 200 calls a day, and the key is passed as an optional environment variable.
Is it an official Microsoft product?
No. The README describes it as an independent, unofficial integration not affiliated with or endorsed by the upstream provider.
Is Onedrive free?
Onedrive has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Onedrive to Claude Code?
Run this command in your terminal: claude mcp add --transport http onedrive https://gateway.pipeworx.io/onedrive/mcp
What are the best alternatives to Onedrive?
The closest alternatives to Onedrive are Google_drive, Google_sheets, The Drive AI, Docupilot MCP by usefulapi and MCP Server for Excel.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
