Kl Sharepoint

License: MIT

A modern Model Context Protocol (MCP) server that lets ChatGPT (and other MCP compatible clients) interact with SharePoint Online and OneDrive content using Microsoft Graph. The server is designed for environments where multiple Microsoft 365 accounts may exist on the same workstation: each session can authenticate with the signed-in Windows/Microsoft account that the user chooses at runtime.

Why this fork? The original SharePoint-only implementation relied on application credentials tied to a specific tenant. This version embraces user-centric authentication (device code flow + MSAL cache) so the connector works with whichever account is selected on the machine—ideal for teams that share GPT licenses but want to access their own SharePoint/OneDrive resources.

Feature Highlights

• 🔐 Device-code authentication – Pick the Microsoft account that is signed into the local machine instead of the ChatGPT account.
• 👥 Multi-account aware – List cached accounts, switch between them, and inspect the active context at any time.
• 🗂️ Drive discovery – Enumerate OneDrive personal drives and SharePoint document libraries.
• 📄 Full file lifecycle – Create folders, upload/update files (text or binary), download contents, and delete resources.
• 🔍 Deep research – Perform scoped searches inside a drive or global Microsoft Graph Search across SharePoint + OneDrive.
• 📚 Site exploration – Search for SharePoint sites and list their document libraries before activating one.

MCP Tools Overview

All tools automatically reuse the selected Microsoft account and drive context.

Prerequisites

1. Azure AD App Registration – Register a public client application (no secret) in Azure AD / Entra ID.
   • Redirect URI can be https://login.microsoftonline.com/common/oauth2/nativeclient.
   • Required delegated permissions: Files.ReadWrite.All, Sites.ReadWrite.All, User.Read, and optionally others you need.
2. Client ID – Note the Application (client) ID of the registration.
3. Python 3.10+ – A recent Python interpreter for running the MCP server.

Configuration

The server is configured with environment variables (you can store them in a .env file during development):

Quickstart

Installation

pip install -e .

Running the server

python -m mcp_sharepoint

Integrate the binary into your MCP-aware client (ChatGPT desktop, Claude Desktop, MCP Inspector, etc.) by referencing the script mcp-sharepoint (created via the console script entry point) or by executing python -m mcp_sharepoint directly.

First-time authentication workflow

1. Call Start_Device_Login from your MCP client.
2. Follow the verification_uri and user_code provided to authenticate with the Microsoft account currently logged into the workstation.
3. Call Complete_Device_Login with the returned flow_id to finish the sign-in.
4. (Optional) Use List_Available_Accounts and Set_Active_Account to switch between cached profiles.
5. Discover drives with List_My_Drives or List_Site_Drives, then select one using Set_Active_Drive.
6. You are ready to browse, search, and modify files using the rest of the tools.

Development

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

Use the MCP Inspector to debug traffic:

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

License

This project is released under the MIT License.