Skip to content
MCP server

Onedrive

MCP server giving AI clients read access to OneDrive files via Microsoft Graph

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/onedrive/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onedrive": {
      "url": "https://gateway.pipeworx.io/onedrive/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers