io.github.nagarjunr/data-connectors-onedrive (MCP) Server

This read-only MCP server provides OneDrive access by listing files and folders via the Microsoft Graph API. It is designed to support data connector workflows that integrate OneDrive content into systems that consume MCP tools.

🛠️ Key Features

Read-only access
OneDrive file/folder listing
Uses Microsoft Graph API
Exposes topics relevant to data connectors (see tags below)

🚀 Use Cases

RAG and LLM pipelines that need OneDrive source discovery
Data connector integrations for AI agents
Data pipeline components that enumerate OneDrive content before ingestion

⚡ Developer Benefits

Straightforward OneDrive browsing via Graph-based listing
MCP-compatible connector for developer tooling
Clear scoping as a read-only listing connector

⚠️ Limitations

Read-only: cannot modify OneDrive content
Functionality described is limited to listing files/folders

🧩 Topics

ai-agents, connector, data-connectors, data-pipeline, google-cloud-storage, llm, onedrive, postgresql, python, rag, s3, sharepoint

OneDrive MCP Server

Read-only MCP server exposing OneDriveClient to AI agents: list files/folders via the Microsoft Graph API.

Tools

Tool	Description
`list_items(path: str \| None = None) -> list[str]`	List item names in a folder (default: configured `ONEDRIVE_DIRECTORY`)
`read_object_text(remote_path: str, max_bytes: int = 1_000_000) -> str`	Read a file's content as UTF-8 text. Refuses (raises) files larger than `max_bytes` rather than truncating.

OneDriveClient's other methods (download(), sync_files_and_folders()) write to a local filesystem path, which an agent doesn't have, so they aren't wrapped.

Environment Variables

Variable	Required	Default	Notes
`ONEDRIVE_CLIENT_ID`	yes	—	Azure AD app client ID
`ONEDRIVE_CLIENT_SECRET`	yes	—	Azure AD app client secret
`ONEDRIVE_TENANT_ID`	yes	—	Azure AD tenant ID
`ONEDRIVE_SITE_ID`	yes	—	SharePoint site ID backing the OneDrive drive
`ONEDRIVE_DIRECTORY`	no	`""` (drive root)	Default folder path to list
`ONEDRIVE_HOST`	no	`yourcompany.sharepoint.com`

local_directory (a required constructor arg on the underlying client) is defaulted internally to /tmp/onedrive-mcp — it's only read by the download/sync methods this server doesn't expose, so it isn't surfaced as configuration here.

Run locally

bash

pip install "data-connectors-ai[onedrive,mcp]"
data-connectors-onedrive-mcp

Use with an MCP client

json

{
  "mcpServers": {
    "onedrive": {
      "command": "uvx",
      "args": ["--from", "data-connectors-ai[onedrive,mcp]", "data-connectors-onedrive-mcp"],
      "env": {
        "ONEDRIVE_CLIENT_ID": "...",
        "ONEDRIVE_CLIENT_SECRET": "...",
        "ONEDRIVE_TENANT_ID": "...",
        "ONEDRIVE_SITE_ID": "..."
      }
    }
  }
}

Registry

Published at io.github.nagarjunr/data-connectors-onedrive on the official MCP registry.

OneDrive Connector