pnp/cli-microsoft365-mcp-server

💡 Description
This MCP server allows the use of natural language to execute any CLI for Microsoft 365 commands. It may handle complex prompts that will be executed as a chain of CLI for Microsoft 365 commands that will try to fulfill the user's request. Thanks to this, you may manage many different areas of Microsoft 365, for example: Entra ID, OneDrive, OneNote, Outlook, Planner, Power Apps, Power Automate, Power Platform, SharePoint Embedded, SharePoint Online, Teams, Viva Engage, and many more...
For best results, use it with Claude Sonnet 4 or Claude Sonnet 3.7.
📦 Prerequisites
- Node.js 20.x or higher
- CLI for Microsoft 365 installed globally (npm i -g @pnp/cli-microsoft365)
🚀 Installation & Usage
👉 Check out the CLI for Microsoft 365 MCP Server Guide
👉 Check out the Getting Started recording 🎬
This MCP server uses the globally installed CLI for Microsoft 365 that you need to install globally using npm i -g @pnp/cli-microsoft365.
After you install the CLI for Microsoft 365 perform the initial setup by running the:
For more information, please follow the Log in to Microsoft 365
After you set up the CLI for Microsoft 365, please update its configuration using the following commands:
This will ensure that the MCP server will get as much information as possible from the CLI for Microsoft 365 when an error occurs or when a command is not executed properly.
The MCP server will not do any authentication for you. You will need to first authenticate using CLI for Microsoft 365 using m365 login command. Once you are authenticated, the MCP server will use the same authentication context when running any tool.
Lastly, install the MCP server on your preferred MCP client, referring to the instructions of the picked MCP host. Below, you may find guidance for VS Code.
Add to VS Code
There are multiple ways to add the MCP server to VS Code. The most common way is to:
1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS) and type MCP: Add Server.
2. Select Command (stdio) as the server type.
3. Enter the command to run the MCP server, which is:
4. Name the server (e.g., CLI for Microsoft 365 MCP Server).
As a result, you should have the following configuration in your .vscode/mcp.json file:
Now when you open the GitHub Copilot chat in VS Code, you should be able to select the CLI for Microsoft 365 MCP Server from the list of available MCP servers and start using it to manage Microsoft 365 using natural language. In the prompt specify that "Using CLI for Microsoft 365, I want you to..." and GitHub Copilot Agent will use the MCP server to execute your request.
Add to GitHub Copilot CLI
If you are using GitHub Copilot CLI, you may add the CLI for Microsoft 365 MCP server to Copilot by doing the following:
1. First of all start the Copilot CLI by running:
2. Use the copilot mcp command to add the MCP server:
3. This will open up the MCP form where you need to fill in the following details:
- Server name: basically whatever you like, but do not use space bar characters, e.g cli-microsoft365-mcp-server
- Server type: select Local
- Command: npx
- Arguments: "-y", "@pnp/cli-microsoft365-mcp-server@latest"
Rest of the fields you may leave with default values.
After that click on Ctrl+S to save the MCP server and q to exit the MCP form.
Now you should be able to use the CLI for Microsoft 365 MCP server in GitHub Copilot CLI by specifying it in your prompt, e.g. "Using CLI for Microsoft 365, I want you to...".
Add to Claude
When using Claude Desktop you may add the MCP server by adding it manually to the Claude Desktop configuration.
Manually add to Claude Desktop configuration
1. In Claude Desktop, open Settings by clicking on the hamburger icon in the top left corner.