MCP Sharepoint

🚀 Microsoft SharePoint MCP Server

A lightweight MCP server for seamless integration with Microsoft SharePoint, enabling MCP clients to interact with documents, folders, and other SharePoint resources. Developed by sofias tech.

✨ Features

This server provides a clean interface to SharePoint resources via the Model Context Protocol (MCP) and is optimized for document management operations.

Tools

The server implements the following tools:

• List_SharePoint_Folders: Lists all folders in a specified directory or the root directory.
• List_SharePoint_Documents: Retrieves all documents within a specified folder.
• Get_Document_Content: Retrieves the content of a document (either as text or Base64-encoded binary).
• Create_Folder: Creates a new folder in a specified directory or the root directory.
• Upload_Document: Uploads a new document to a specified folder.
• Update_Document: Updates the content of an existing document.
• Delete_Document: Deletes a document from a specified folder.
• Delete_Folder: Deletes an empty SharePoint folder.

🔧 Technical Details

The server is designed with resource efficiency in mind:

• Efficiently uses the SharePoint API through selective property loading.
• Implements clean error handling using decorators.
• Clearly separates resource management from tool implementation.
• Optimizes content handling for both text and binary files.

📦 Installation

Prerequisites

1. Register an application in Azure AD with appropriate SharePoint permissions.
2. Obtain the client ID and client secret of the registered application.
3. Determine your SharePoint site URL and the path to the document library you want to operate on.

Environment Variables

The server requires the following environment variables:

• SHP_ID_APP: Your Azure AD application client ID.
• SHP_ID_APP_SECRET: Your Azure AD application client secret.
• SHP_SITE_URL: Your SharePoint site URL.
• SHP_DOC_LIBRARY: The path to the document library (default: "Shared Documents/mcp_server").
• SHP_TENANT_ID: Your Microsoft tenant ID.

Installation Commands

pip install -e .

Or after it's published to PyPI:

pip install mcp-sharepoint-server

Using uv:

uv pip install mcp-sharepoint-server

🚀 Quick Start

Claude Desktop Integration

To integrate with Claude Desktop, update the configuration file:

On Windows: %APPDATA%/Claude/claude_desktop_config.json On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Standard Integration

"mcpServers": {
  "sharepoint": {
    "command": "mcp-sharepoint",
    "env": {
      "SHP_ID_APP": "your-app-id",
      "SHP_ID_APP_SECRET": "your-app-secret",
      "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
      "SHP_DOC_LIBRARY": "Documents"
    }
  }
}

Advanced Configuration

You can also configure additional settings via the following environment variables:

• SHP_API_VERSION: Specifies the SharePoint API version to use (default: "v1.0").
• SHP_AUTH_TYPE: Specifies the authentication type (supports "AzureAD" and "Guest", default: "AzureAD").

💻 Development

Install Dependencies

Install the required libraries using pip:

pip install -r requirements.txt

Local Development

1. Clone the repository:

   git clone https://github.com/yourusername/mcp-sharepoint.git
   cd mcp-sharepoint
   

2. Install dependencies (as described above).
3. Run the server:

   python -m mcp_sharepoint
   

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Copyright (c) 2025 sofias tech