OneDrive MCP Server

@karthik20

About OneDrive MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "onedrive-mcp-server-spring": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "8080:8080",
        "-e",
        "ONEDRIVE_ACCESS_TOKEN=your-token",
        "karthik20/onedrive-mcp-server:0.0.1"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OneDrive MCP Server?

A Model Context Protocol (MCP) server that enables AI agents to search and navigate files and folders in Microsoft OneDrive. Built with Spring Boot and Spring AI, it uses the Microsoft Graph API for secure access.

How to use OneDrive MCP Server?

Set your Microsoft OneDrive access token via the MICROSOFT_ONEDRIVE_ACCESS_TOKEN environment variable. Run the server using the JAR (java -jar target/onedrive-mcp-server-0.0.1.jar) or via Docker (docker run -e MICROSOFT_ONEDRIVE_ACCESS_TOKEN=... karthik20/onedrive-mcp-server:0.0.1). Configure MCP clients (VS Code, GitHub Copilot, Claude Desktop) to point to the server’s endpoint.

Key features of OneDrive MCP Server

Search files in OneDrive with optional folder filtering
Search and navigate folder structures
Get direct web URLs to files and folders
MCP-compatible interface for AI agent integration
Secure access using Microsoft Graph API

Use cases of OneDrive MCP Server

An AI assistant finds a specific document across OneDrive folders
A user asks the AI to list all files in a given folder path
The AI retrieves a direct web link to a file for sharing
An AI agent navigates nested folder structures to locate content
Automated file discovery in developer workflows via MCP clients

FAQ from OneDrive MCP Server

How do I obtain a Microsoft OneDrive access token?

Two methods: use Microsoft Graph Explorer for a quick temporary token (good for testing), or register your own application in the Azure Portal for a longer-lived token (recommended for production).

What permissions are required for the access token?

The access token needs the Files.Read and Files.Read.All delegated permissions on Microsoft Graph.

Can I run the server using Docker?

Yes. Build the Docker image with mvn spring-boot:build-image and run the container with docker run. The official image is karthik20/onedrive-mcp-server:0.0.1.

What are the runtime prerequisites?

Java 21 or higher, Maven 3.6+ (for building), and optionally Docker for containerized deployment.

How long does the access token last?

Tokens from Graph Explorer expire after a few hours. Tokens obtained from your registered Azure app are valid for several hours. For production use, implement a proper OAuth2 token refresh flow.

Frequently asked questions