# PnP PowerShell (nuget · PnP.PowerShell.MCPServer)

Manage Microsoft 365 in natural language with PnP PowerShell and author PnP PowerShell scripts.

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

## Components

- nuget · `PnP.PowerShell.MCPServer`: 70/100 (this document), [markdown](https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver.md), [page](https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver)

## Channel facts

- Registry: `nuget`
- Package: `PnP.PowerShell.MCPServer`
- Version: `0.1.7-beta`
- 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-10-17.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Build provenance not yet verified.
  - Licence could not be checked: the licence is shipped as a file inside the package, not declared as a standard (SPDX) licence identifier, so we cannot tell whether it is OSI-approved.
  - Actively maintained (last published 11 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 84/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2199 tokens (~137/item across 16 items; 15 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **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.
  - Structured output schemas are declared (53% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 15 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the PnP PowerShell MCP server?

PnP PowerShell runs locally as a NuGet package, launched with dnx PnP.PowerShell.MCPServer@0.1.7-beta --yes. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add pnp-pnp-powershell-mcp-server -- dnx PnP.PowerShell.MCPServer@0.1.7-beta --yes
```

### Cursor

```json
{
  "mcpServers": {
    "pnp-pnp-powershell-mcp-server": {
      "command": "dnx",
      "args": [
        "PnP.PowerShell.MCPServer@0.1.7-beta",
        "--yes"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "pnp-pnp-powershell-mcp-server": {
      "command": "dnx",
      "args": [
        "PnP.PowerShell.MCPServer@0.1.7-beta",
        "--yes"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add pnp-pnp-powershell-mcp-server -- dnx PnP.PowerShell.MCPServer@0.1.7-beta --yes
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pnp-pnp-powershell-mcp-server": {
      "type": "local",
      "command": [
        "dnx",
        "PnP.PowerShell.MCPServer@0.1.7-beta",
        "--yes"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  pnp-pnp-powershell-mcp-server:
    command: "dnx"
    args: ["PnP.PowerShell.MCPServer@0.1.7-beta", "--yes"]
```

### Netclaw

```json
{
  "McpServers": {
    "pnp-pnp-powershell-mcp-server": {
      "Transport": "stdio",
      "Command": "dnx",
      "Arguments": [
        "PnP.PowerShell.MCPServer@0.1.7-beta",
        "--yes"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "pnp-pnp-powershell-mcp-server": {
      "command": "dnx",
      "args": [
        "PnP.PowerShell.MCPServer@0.1.7-beta",
        "--yes"
      ]
    }
  }
}
```

## 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-10-15 (score 70, +34)

- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 53
- [functional] First check of Tool coverage: 100

### 2026-10-12 (score 36, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-08 (score 21)

First indexed and scored.

## MCP tools (15)

### `pnp_search_script_samples` (~122 tokens)

Browses the catalogue of community PnP Script Samples, plus the user's own, by keyword and returns titles, descriptions and reference links only, never any code. Use it to see what solutions already exist in an area.

Input parameters:

- `limit` (integer): Maximum number of results to return (default: 10, max: 50)
- `query` (string, required): Keywords describing the task or area to browse for (e.g., 'document set', 'teams bulk create', 'export list items csv', 'site permissions report', 'hub site')

Output parameters:

- `count` (integer)
- `matched` (integer)
- `query` (string)
- `samples` (array)
- `truncated` (boolean)

### `pnp_reset_session` (~80 tokens)

Signs out: ends a session and discards everything held in it, so the next call starts fresh and must reconnect. Use it to sign out or log out, to switch to a different account, or to recover a session that has wedged or stopped responding.

Input parameters:

- `sessionId` (string|null): Session to end (default: "default")

### `pnp_setup_environment` (~162 tokens)

Installs the PnP.PowerShell module for the current user so PnP cmdlets can run, choosing the released build or the latest pre-release. It installs only that module: it never signs in, never touches the tenant, and creates no app registration. For safety it installs only when PNP_MCP_ALLOW_SETUP=true; otherwise it returns the exact Install-Module command to run by hand. Use it when the PnP.PowerShell module is not installed.

Input parameters:

- `prerelease` (boolean): Install the latest pre-release build instead of the released one (adds -AllowPrerelease). Ask the user which they want. Default: false.
- `sessionId` (string|null): Session to run the install in (default: "default")

Output parameters:

- `allowed` (boolean)
- `command` (string)
- `installed` (boolean)
- `moduleVersion` (string|null)

### `pnp_get_connection_status` (~87 tokens)

Reports the connection state of one session: whether it is signed in right now, which site URL it holds, and which account it is authenticated as. Check it before connecting, so an existing connection is reused rather than opened again, and to find out who you are and where you are pointed.

Input parameters:

- `sessionId` (string|null): Session to inspect (default: "default")

Output parameters:

- `account` (string|null)
- `connected` (boolean)
- `connectionType` (string|null)
- `message` (string|null)
- `sessionId` (string)
- `tenantAdminUrl` (string|null)
- `url` (string|null)

### `pnp_get_command_docs` (~97 tokens)

Gets the reference documentation for one named cmdlet: its syntax, every parameter and what it means, the parameter sets, and examples. Use it once you know the cmdlet name and need to know how to call it.

Input parameters:

- `commandName` (string, required): The full PnP PowerShell command name (e.g., "Get-PnPWeb", "Connect-PnPOnline", "Get-PnPList")

### `pnp_search_commands` (~170 tokens)

Answers the question "which cmdlet handles this, and what is it called?". Searches cmdlet names, verbs, nouns, descriptions, parameters and examples to discover whether one exists for the area you need to manage or work with. Describe the task in your own words -- "add a column to a list", "share a file externally" -- or pass keywords. Use it whenever the cmdlet name is unknown. Returns names, synopses, parameters and documentation links, never tenant data.

Input parameters:

- `limit` (integer): Maximum number of results to return (default: 20, max: 100)
- `query` (string, required): What you are trying to do, in plain words or as keywords (e.g., "find sites with no owner", "teams channel", "upload file")

Output parameters:

- `aliasResolvedTo` (string|null)
- `commands` (array)
- `count` (integer)
- `detailOmitted` (boolean)
- `indexedModuleVersion` (string|null)
- `matched` (integer)
- `query` (string)
- `truncated` (boolean)

### `pnp_run_command` (~216 tokens)

Runs PnP PowerShell against the connected tenant and returns what it produced. This is the tool that does the actual work: use it to create, read, update, set, change, add, remove, delete, list, upload, download, copy, move, restore or report on sites, lists, libraries, files, folders, list items, users, groups, permissions, Teams, Entra ID objects, and tenant or site settings. Chain steps with semicolons or newlines. The Connect-PnPOnline connection persists across calls sharing a sessionId, so connect once and keep going.

Input parameters:

- `command` (string, required): PnP PowerShell command(s) to execute (e.g., "Get-PnPSite", "Get-PnPList | Select-Object Title, ItemCount")
- `sessionId` (string|null): Session to run in. Sessions keep their own PnP connection, so use a second name only when working against two tenants at once (default: "default")

### `pnp_get_script_sample` (~94 tokens)

Opens one specific sample already identified, addressed by the exact slug name a browse returned, and gives back its complete script body. Use it when you know precisely which sample you want.

Input parameters:

- `sampleName` (string, required): The sample slug name returned by pnp_search_script_samples (e.g., 'spo-create-documentset', 'teams-bulk-create-teams', 'spo-export-sharepoint-list-items-to-csv')

### `pnp_save_script_sample` (~104 tokens)

Saves a PnP PowerShell script to the user's own samples for reuse, so later searches and suggestions include it. Use it only when the user asks to keep or save a script. It never overwrites an existing file.

Input parameters:

- `name` (string, required): File name without extension
- `script` (string, required): The complete PnP PowerShell code
- `synopsis` (string, required): One line on what it does, kept as its .SYNOPSIS

### `pnp_get_result_page` (~121 tokens)

Returns the next page of a result set that pnp_run_command summarised because it was too large to return whole. Pages over rows already fetched, so it costs nothing against the tenant and returns exactly the rows the original command saw. Use the cursor and offset printed under the summary.

Input parameters:

- `cursor` (string, required): The cursor printed with the summary, e.g. "a1b2c3d4e5"
- `offset` (integer): Zero-based row number to start from, as printed in the MORE line of the previous page

Output parameters:

- `cursor` (string)
- `nextOffset` (integer|null)
- `offset` (integer)
- `pageableRows` (integer)
- `sessionId` (string)
- `totalRows` (integer)

### `pnp_suggest_script` (~150 tokens)

Drafts a starting point for a job someone wants to automate, by matching the task against the user's own and community samples and returning their code plus guidance on adapting it. The entry point when a job is described rather than a cmdlet named.

Input parameters:

- `maxSamples` (integer): Maximum number of sample scripts to return (default: 3, max: 5)
- `task` (string, required): A natural-language description of what you want to accomplish with PnP PowerShell. Be as specific as possible (e.g., 'Export all SharePoint list items to a CSV file', 'Bulk create Microsoft Teams fro…

### `pnp_diagnose_connection` (~216 tokens)

Diagnoses a broken or unfamiliar machine and reports whether its environment is set up, and answers how to sign in to it. Verifies everything that must be true before anything can run: pwsh installed and on PATH, the PnP.PowerShell module present and current enough, whether this session is connected, and which app registration, persisted login or certificate this machine can actually authenticate with. Every failing check names its cause and the next command to run, filling in every value the machine's own state can supply. Call it before the first Connect-PnPOnline rather than composing one from memory, and whenever something is wrong or fails for a reason that is not obvious.

Input parameters:

- `sessionId` (string|null): Session to inspect (default: "default")
- `targetUrl` (string|null): The SharePoint site the caller wants to work against, e.g. "https://contoso.sharepoint.com/sites/marketing". Given one, the report names the exact connect command for that host instead of a template.

Output parameters:

- `account` (string|null)
- `connected` (boolean)
- `moduleInstalled` (boolean)
- `moduleVersion` (string|null)
- `pwshAvailable` (boolean)
- `pwshVersion` (string|null)
- `ready` (boolean)
- `sessionId` (string)
- `url` (string|null)

### `pnp_ping` (~92 tokens)

Returns the server version, uptime, read-only mode status, and active session count, plus (unless includeReadiness is false) a one-line readiness flag. Use this as a lightweight health check to confirm the server itself is responsive.

Input parameters:

- `includeReadiness` (boolean): Also probe whether pwsh and the PnP.PowerShell module are installed (launches a short-lived pwsh). Default: true.

Output parameters:

- `activeSessions` (integer)
- `packageVersion` (string)
- `pnpModuleInstalled` (boolean|null)
- `pnpModuleVersion` (string|null)
- `pwshAvailable` (boolean|null)
- `readOnlyMode` (boolean)
- `startedUtc` (string)
- `status` (string)
- `uptime` (string)
- `version` (string)

### `pnp_get_best_practices` (~114 tokens)

Returns this server's own guidance and recommended workflow: how to approach a task, the rules it enforces, how to treat tenant text that reads like an instruction, and the conventions to follow. The full document is long, so pass a section to read one topic.

Input parameters:

- `section` (string|null): Optional topic to return instead of the whole document. One of: workflow, docs, sessions, config, readonly, output, destructive, trust, auth, execution, patterns. Omit for everything.

### `pnp_list_sessions` (~42 tokens)

Lists all active PowerShell sessions with their status and last activity time. Use this to see what sessions exist before deciding which to connect, reset, or reuse.

Output parameters:

- `count` (integer)
- `sessions` (array)
- `total` (integer)
- `truncated` (boolean)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver#diagnostics

## Score history

- 2026-10-17: 70
- 2026-10-16: 70
- 2026-10-15: 70
- 2026-10-14: 36
- 2026-10-13: 36
- 2026-10-12: 36
- 2026-10-08: 21

## Common questions

### What is the PnP PowerShell MCP server?

PnP PowerShell is an MCP server listed in the public MCP registry as io.github.pnp/pnp-powershell-mcp-server. Manage Microsoft 365 in natural language with PnP PowerShell and author PnP PowerShell scripts. This page covers its NuGet package (PnP.PowerShell.MCPServer).

### Is the PnP PowerShell MCP server safe to use?

PnP PowerShell scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 17 October 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the PnP PowerShell MCP server expose?

PnP PowerShell exposes 15 tools: pnp_search_script_samples, pnp_reset_session, pnp_setup_environment, pnp_get_connection_status, pnp_get_command_docs, and 10 more. Their descriptions and schemas cost roughly 1,867 tokens of context every time the server is loaded.

### Is the PnP PowerShell MCP server still maintained?

PnP PowerShell is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- NuGet package: https://www.nuget.org/packages/PnP.PowerShell.MCPServer
- Socket report: https://socket.dev/nuget/package/PnP.PowerShell.MCPServer
- Repository: https://github.com/pnp/pnp-powershell-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver.xml
- Changelog JSON feed: https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver.json
- HTML version of this page: https://verifymcp.io/servers/pnp-pnp-powershell-mcp-server/pnp-powershell-mcpserver