# Onedrive

> Onedrive is a freemium MCP server for files and documents. MCP server giving AI clients read access to OneDrive files via Microsoft Graph. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/onedrive
- **Repository:** https://github.com/pipeworx-io/mcp-onedrive
- **MCP Registry name:** io.github.pipeworx-io/onedrive
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http onedrive https://gateway.pipeworx.io/onedrive/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/onedrive/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onedrive": {
      "url": "https://gateway.pipeworx.io/onedrive/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onedrive": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/onedrive/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onedrive": {
      "serverUrl": "https://gateway.pipeworx.io/onedrive/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onedrive": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/onedrive/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Google_sheets](https://ai-powered.com/mcp/google-sheets-3): Google_sheets is a freemium MCP server for files and documents.
- [The Drive AI](https://ai-powered.com/mcp/the-drive-ai): The Drive AI is a freemium MCP server for files and documents.
- [Docupilot MCP by usefulapi](https://ai-powered.com/mcp/docupilot-mcp-by-usefulapi): Docupilot MCP by usefulapi is a freemium MCP server for files and documents.
- [MCP Server for Excel](https://ai-powered.com/mcp/mcp-server-for-excel): MCP Server for Excel is an open-source MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/onedrive
