Sharepoint

You can empower your AI agents with live access to your SharePoint knowledge by running a production-grade MCP server that connects to SharePoint folders, documents, and metadata. This server exposes MCP-compatible endpoints that enable agents to read, reason about, and act on your organization’s SharePoint data in real time.

How to use

You can connect your MCP-compatible agent to the SharePoint MCP server through either a local stdio setup or a remote HTTP server. Use the stdio path for local development and desktop integrations, or the HTTP path when you deploy the server in Docker or expose it to remote agents. Once connected, your agent can list folders, navigate document libraries, read full document contents, translate or modify documents, and read or edit metadata in SharePoint. The agent’s actions execute against live SharePoint data, enabling accurate reasoning and streamlined workflows.

How to install

Prerequisites: you should have Python installed and, optionally, Docker for containerized deployment.

# Install from PyPI
pip install sharepoint-mcp

# Or install from source
# git clone https://github.com/ravikant1918/sharepoint-mcp.git
# cd sharepoint-mcp
# pip install -e .

Additional steps you may need

Prepare environment variables to authorize access to your SharePoint tenant. You will typically provide an Azure AD app client ID and secret, your tenant ID, and the SharePoint site URL. The following environment variables are used by the server and should be included in your environment or a .env file.

SHP_ID_APP=your-azure-app-client-id
SHP_ID_APP_SECRET=your-azure-app-secret
SHP_TENANT_ID=your-tenant-id
SHP_SITE_URL=https://your-tenant.sharepoint.com/sites/your-site

New to Azure AD? Follow the Azure setup steps to register an app and grant permissions for SharePoint access.

## Start the server (two connection options)

Standard, repeatable start commands are shown in the integration examples. You can run a local stdio server or connect via HTTP for remote or containerized deployment.

Local stdio server start command (example): use the runtime command shown in your setup. If your configuration uses the command sharepoint-mcp, run it directly in your shell.

## Available tools

### List\_SharePoint\_Folders

List all sub-folders within a directory in the current SharePoint library.

### Get\_SharePoint\_Tree

Retrieve the full, recursive folder and file tree starting from a given path.

### Create\_Folder

Create a new folder within a specified directory.

### Delete\_Folder

Delete an empty folder.

### List\_SharePoint\_Documents

List all files in a library or folder with metadata.

### Get\_Document\_Content

Read and parse content from PDFs, Word, Excel, or text files.

### Upload\_Document

Upload a file to SharePoint as a string or Base64-encoded payload.

### Upload\_Document\_From\_Path

Upload a local file directly from your filesystem.

### Update\_Document

Overwrite content of an existing document.

### Delete\_Document

Permanently delete a document from SharePoint.

### Download\_Document

Download a document to the local filesystem.

### Get\_File\_Metadata

Read all SharePoint list-item fields for a file.

### Update\_File\_Metadata

Update metadata fields on a SharePoint list item.