SharePoint

Provides Claude access to SharePoint via Microsoft Graph, enabling folders, documents, and metadata operations through MCP.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "peacockery-studio-sharepoint-mcp": {
      "command": "node",
      "args": [
        "/path/to/sharepoint-mcp/index.js"
      ],
      "env": {
        "SHAREPOINT_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
        "SHAREPOINT_CLIENT_ID": "YOUR_CLIENT_ID",
        "SHAREPOINT_TENANT_ID": "YOUR_TENANT_ID",
        "SHAREPOINT_DOC_LIBRARY": "Shared Documents",
        "SHAREPOINT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

This MCP server gives Claude access to Microsoft SharePoint through the Microsoft Graph API, enabling folder management, document operations, and metadata handling via a secure OAuth flow. It follows a modular pattern that keeps authentication, folders, and documents separate for easy maintenance and reliable operation.

How to use

You will run the local MCP server and then interact with it from Claude using the defined tools. Authenticate once to obtain tokens, then perform common tasks such as listing folders, creating folders, uploading documents, and reading or updating metadata. The server provides an OAuth flow to securely sign in and refresh tokens as needed.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

cd sharepoint-mcp
npm install

Additional configuration and usage notes

Configure the MCP server for your SharePoint and Azure AD environment. Use the client ID, client secret, tenant ID, and site URL from your Azure AD app registration to enable OAuth and Graph API access.

Environment variables required by the server are shown in the integration example and should be provided to the runtime environment when starting the server.

Troubleshooting and security

If you encounter authentication issues, ensure you have completed browser-based authentication and that tokens are stored in the expected location. Verify admin consent for Graph API permissions and confirm the site URL is correct.

Notes on usage patterns

Use the authentication flow to obtain tokens, then call folder and document operations to manage your SharePoint content. You can upload documents, read their content, fetch and update metadata, and download documents as needed.

Available tools

authenticate

Start the OAuth authentication flow to obtain access tokens.

check_auth_status

Check the current authentication status and token validity.

logout

Clear stored tokens and sign out from the OAuth session.

list_folders

List folders within a specified directory.

create_folder

Create a new folder in a directory.

delete_folder

Delete an empty folder.

get_folder_tree

Retrieve the recursive folder structure.

list_documents

List documents in a folder.

get_document_content

Read content of a document.

upload_document

Upload new content as a document.

upload_document_from_path

Upload a local file as a new document.

update_document

Update an existing document.

delete_document

Delete a document.

download_document

Download a document to the local filesystem.

get_file_metadata

Get metadata fields for a file.

update_file_metadata

Update metadata fields on a file.

Built by

VeilStrat

AI signals for GTM teams