# io.github.0xka13b/ms-sharepoint-mcp (npm · ms-sharepoint-mcp)

Microsoft SharePoint MCP server — access sites, lists, and documents through Microsoft Graph.

- Trust score: 70/100 (medium)
- Change this week: +24
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `ms-sharepoint-mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp.md), [page](https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp)

## Channel facts

- Registry: `npm`
- Package: `ms-sharepoint-mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (110 of 111), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (110 of 111), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 55 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2012 tokens (~87/item across 23 items; 23 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add 0xka13b-ms-sharepoint-mcp -- npx -y ms-sharepoint-mcp
```

### Codex

```bash
codex mcp add 0xka13b-ms-sharepoint-mcp -- npx -y ms-sharepoint-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "0xka13b-ms-sharepoint-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ms-sharepoint-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add 0xka13b-ms-sharepoint-mcp --command npx --arg -y --arg ms-sharepoint-mcp
```

### Hermes

```yaml
mcp_servers:
  0xka13b-ms-sharepoint-mcp:
    command: "npx"
    args: ["-y", "ms-sharepoint-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "0xka13b-ms-sharepoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ms-sharepoint-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 69, +48)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional] Licence: MIT

### 2026-07-31 (score 21, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (23)

### `list_sites` (~81 tokens)

Search and list SharePoint sites accessible to the signed-in user.

Input parameters:

- `search` (string): Keyword to filter sites by display name. Omit or use '*' to list all accessible sites.
- `skip` (integer): Number of results to skip for pagination (default 0).
- `top` (integer): Maximum number of sites to return (default 50).

### `get_site` (~76 tokens)

Get metadata for a SharePoint site by its Graph site ID or hostname:path form.

Input parameters:

- `site_id` (string, required): Site identifier — either a Graph GUID (e.g. 'contoso.sharepoint.com,abc123,xyz456') or 'hostname:/path' (e.g. 'contoso.sharepoint.com:/sites/hr').

### `get_site_id` (~77 tokens)

Resolve a SharePoint site hostname and server-relative path to its Graph GUID. Use the returned id with other tools.

Input parameters:

- `hostname` (string, required): SharePoint hostname, e.g. 'contoso.sharepoint.com'.
- `path` (string, required): Server-relative site path, e.g. '/sites/hr'. Use '/' for the root site.

### `get_drive` (~66 tokens)

Get the default document library (drive) for a SharePoint site, or a specific drive when drive_id is supplied.

Input parameters:

- `drive_id` (string): Specific drive ID. Omit to get the site's default document library.
- `site_id` (string, required): SharePoint Graph site ID.

### `list_lists` (~33 tokens)

List all lists and document libraries in a SharePoint site.

Input parameters:

- `site_id` (string, required): SharePoint Graph site ID.

### `get_list` (~59 tokens)

Get metadata and column schema for a specific SharePoint list or library.

Input parameters:

- `list_id` (string, required): List ID (GUID) or list display name (e.g. 'Shared Documents').
- `site_id` (string, required): SharePoint Graph site ID.

### `list_columns` (~44 tokens)

List all column definitions for a SharePoint list.

Input parameters:

- `list_id` (string, required): List ID or display name.
- `site_id` (string, required): SharePoint Graph site ID.

### `list_items` (~132 tokens)

Query items in a SharePoint list with optional OData $filter, $select, and pagination.

Input parameters:

- `filter` (string): OData $filter expression applied to item fields, e.g. "fields/Status eq 'Active'".
- `list_id` (string, required): List ID or display name.
- `select` (string): Comma-separated field names to include in each item's fields object.
- `site_id` (string, required): SharePoint Graph site ID.
- `skip` (integer): Number of items to skip (default 0).
- `top` (integer): Maximum items to return (default 100).

### `get_item` (~64 tokens)

Get a single SharePoint list item by its ID, including all field values.

Input parameters:

- `item_id` (string, required): List item ID (numeric string).
- `list_id` (string, required): List ID or display name.
- `site_id` (string, required): SharePoint Graph site ID.

### `create_item` (~79 tokens)

Create a new item in a SharePoint list.

Input parameters:

- `fields` (object, required): Key-value map of field internal names to values, e.g. { "Title": "New item", "Status": "Active" }.
- `list_id` (string, required): List ID or display name.
- `site_id` (string, required): SharePoint Graph site ID.

### `update_item` (~74 tokens)

Update one or more fields of an existing SharePoint list item.

Input parameters:

- `fields` (object, required): Fields to update as internal-name to value pairs.
- `item_id` (string, required): List item ID.
- `list_id` (string, required): List ID or display name.
- `site_id` (string, required): SharePoint Graph site ID.

### `delete_item` (~56 tokens)

Permanently delete a SharePoint list item.

Input parameters:

- `item_id` (string, required): List item ID to delete.
- `list_id` (string, required): List ID or display name.
- `site_id` (string, required): SharePoint Graph site ID.

### `upload_file` (~140 tokens)

Upload a file to a SharePoint document library. Files over 4 MB are automatically chunked via an upload session.

Input parameters:

- `conflict_behavior` (string): How to handle name conflicts (default: replace).
- `content_base64` (string, required): Base64-encoded file content.
- `content_type` (string): MIME type of the file (default: application/octet-stream).
- `drive_id` (string): Drive ID. Omit to use the site's default document library.
- `file_path` (string, required): Destination path including filename, e.g. '/Shared Documents/reports/Q1.xlsx'.
- `site_id` (string, required): SharePoint Graph site ID.

### `download_file` (~77 tokens)

Download a file from a SharePoint document library. Returns content as base64.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `file_path` (string, required): File path in the drive, e.g. '/Shared Documents/report.pdf'.
- `site_id` (string, required): SharePoint Graph site ID.

### `create_folder` (~85 tokens)

Create a folder in a SharePoint document library.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `folder_name` (string, required): Name of the new folder.
- `parent_path` (string): Parent folder path, e.g. '/Shared Documents'. Defaults to drive root.
- `site_id` (string, required): SharePoint Graph site ID.

### `delete_file` (~80 tokens)

Permanently delete a file or folder from a SharePoint document library.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `file_path` (string, required): Path of the file or folder to delete, e.g. '/Shared Documents/old-report.pdf'.
- `site_id` (string, required): SharePoint Graph site ID.

### `get_file_content` (~87 tokens)

Retrieve the raw text content of a file in SharePoint. Best for plain-text, CSV, JSON, or Markdown files.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `file_path` (string, required): File path in the drive, e.g. '/Shared Documents/data.csv'.
- `site_id` (string, required): SharePoint Graph site ID.

### `get_file_metadata` (~85 tokens)

Get file properties (name, size, MIME type, created/modified dates, web URL) without downloading content.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `file_path` (string, required): File path in the drive, e.g. '/Shared Documents/report.pdf'.
- `site_id` (string, required): SharePoint Graph site ID.

### `get_document` (~84 tokens)

Retrieve both metadata and text content of a SharePoint file in one call. Optimised for AI consumption of documents.

Input parameters:

- `drive_id` (string): Drive ID. Omit to use the default drive.
- `file_path` (string, required): File path in the drive, e.g. '/Shared Documents/report.txt'.
- `site_id` (string, required): SharePoint Graph site ID.

### `search` (~107 tokens)

Run a Microsoft Search query across SharePoint content with full control over entity types and result shape.

Input parameters:

- `entity_types` (array): Entity types to search (default: ['driveItem', 'listItem']).
- `fields` (array): Specific managed properties to include in results.
- `from` (integer): Offset for pagination (default 0).
- `query_string` (string, required): Search query string. KQL syntax supported.
- `size` (integer): Number of results (default 25).

### `search_sharepoint` (~122 tokens)

Focused full-text search across SharePoint lists and document libraries with ranked results. Supports KQL syntax (e.g. 'budget filetype:xlsx', 'author:"John Smith"').

Input parameters:

- `from` (integer): Pagination offset (default 0).
- `query` (string, required): Search query. KQL syntax supported.
- `site_url` (string): Scope the search to a specific SharePoint site by its URL, e.g. 'https://contoso.sharepoint.com/sites/hr'.
- `size` (integer): Number of results (default 25).

### `get_user_profile` (~33 tokens)

Get the signed-in user's Microsoft 365 profile (id, displayName, mail, jobTitle, department, etc.).

### `create_site` (~271 tokens)

Create a new SharePoint site. Team sites are provisioned via a Microsoft 365 Group (requires Group.ReadWrite.All). Communication sites are created via the SharePoint REST API (requires Sites.FullControl.All).

Input parameters:

- `description` (string): Optional description for the site.
- `display_name` (string, required): Display name for the new site, e.g. 'Marketing Hub'.
- `hostname` (string): SharePoint hostname required for communication sites, e.g. 'contoso.sharepoint.com'.
- `mail_nickname` (string): Email alias for the M365 group (team sites only). Must be unique across the tenant and contain no spaces, e.g. 'marketing-hub'. Derived from display_name if omitted.
- `owners` (array): UPNs or user IDs to set as site owners (team sites only), e.g. ['alice@contoso.com'].
- `site_type` (string, required): 'team' creates a group-connected Team site. 'communication' creates a standalone Communication site.
- `site_url_alias` (string): URL alias for the communication site path, e.g. 'marketing-hub' → /sites/marketing-hub. Derived from display_name if omitted.
- `visibility` (string): Team site visibility (default: Private). Ignored for communication sites.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 69
- 2026-08-01: 21
- 2026-07-31: 21
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/ms-sharepoint-mcp
- Socket report: https://socket.dev/npm/package/ms-sharepoint-mcp
- Repository: https://github.com/0xka13b/microsoft-mcps
- Changelog RSS feed: https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/0xka13b-ms-sharepoint-mcp/ms-sharepoint-mcp