
SharePoint Embedded MCP, Microsoft's server for SharePoint Embedded
Lets your AI assistant create and manage SharePoint Embedded container types and containers, and scaffold apps on them.
This is Microsoft's server for SharePoint Embedded, the Microsoft 365 service for apps that store files in containers. It lets Claude, Cursor or VS Code Copilot set up container types and containers, manage billing and permissions, scaffold and deploy a starter app, and search the docs. It runs on your machine and signs in through the Azure CLI. It is preview software that can create Azure charges and acts on your tenant with your credentials.
Good for
- Developers building apps on SharePoint Embedded
- IT admins who provision and manage containers in a tenant
- Solution architects trying a reference app quickly
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install sharepoint-embedded-mcp-server
Claude Code
- 1
Copy this prompt.
Add the sharepoint-embedded-mcp-server server to Claude Code. Run this command: claude mcp add sharepoint-embedded -- npx -y @microsoft/spe-mcp start Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, Azure CLI.
Read-only mode: Add the --read-only option after start to expose only read, list, get and search tools.
Sign in once with az login --allow-no-subscriptions (install the Azure CLI first). Needs Node.js 22, 24 or 26. The README also lists optional client ID and tenant ID settings if you want to use your own Entra app.
From the project README. Source.
Tools
Shows who you are signed in as and what is ready
Returns your signed-in Azure identity and whether provisioning is ready.
Try: “Am I signed in, and is SharePoint Embedded ready to provision?”
Network ·
status_getLists your container types
Lists SharePoint Embedded container types.
Try: “List my container types.”
Network ·
container_type_listShows one container type
Returns details of a container type.
Try: “Show the Contoso Docs container type.”
Network ·
container_type_getLists containers
Lists containers.
Try: “List my containers.”
Network ·
container_listShows one container
Returns details of a container.
Try: “Show the details of the Contoso Docs container.”
Network ·
container_getLists a container type's owners
Lists who owns a container type. Marked beta in the README.
Try: “Who owns this container type?”
Network ·
container_type_owners_listLists apps allowed on a container type
Lists the application permission grants on a container type registration.
Try: “Which apps can use this container type?”
Network ·
container_type_app_grants_listLists your Azure subscriptions
Lists subscriptions so you can pick where standard billing goes.
Try: “List my Azure subscriptions.”
Network ·
azure_subscriptions_listLists your Azure resource groups
Lists resource groups for billing.
Try: “List the resource groups in my subscription.”
Network ·
azure_resource_groups_listChecks a container type's billing status
Shows the billing classification and trial expiry.
Try: “When does my container type trial expire?”
Network ·
billing_checkSearches the SharePoint Embedded docs
Searches official SharePoint Embedded and Graph docs through the Microsoft Learn MCP server.
Try: “How do I set permissions on a container?”
Network ·
docs_searchReads a Microsoft Learn page
Fetches a full Microsoft Learn documentation page by URL.
Try: “Open that docs page and summarize it.”
Network ·
docs_fetchSearches files in containers
Searches content in containers. Needs content access to be granted first.
Try: “Find files about onboarding in the HR container.”
Network ·
content_searchPreviews a file in a container
Gets a preview of a file in a container.
Try: “Preview the offer letter template.”
Network ·
content_file_previewCreates the Entra app that owns your containers
Creates the owning app in Microsoft Entra using your Azure CLI sign-in.
Try: “Create the owning app for my SharePoint Embedded project.”
Write ·
project_app_createSets everything up in one go
Creates the app, a container type, billing if needed, registration and a container in one call.
Try: “Provision a new SharePoint Embedded project called Contoso Docs.”
Write ·
project_provisionCreates a container type
Creates a container type.
Try: “Create a trial container type called Contoso Docs.”
Write ·
container_type_createRegisters a container type in your tenant
Registers a container type so apps can use it.
Try: “Register the Contoso Docs container type.”
Write ·
container_type_registerCreates a container
Creates a container.
Try: “Create a container called Contract Files.”
Write ·
container_createUpdates a container type
Changes settings of a container type.
Try: “Rename my container type.”
Write ·
container_type_updateAdds an owner to a container type
Grants ownership of a container type. Marked beta in the README.
Try: “Make this app an owner of the container type.”
Write ·
container_type_grant_ownerLets an app use a container type
Adds an application permission grant to a container type registration.
Try: “Allow my web app to use this container type.”
Write ·
container_type_app_grant_addSets up billing for a container type
Registers the Microsoft.Syntex resource provider and links the container type for standard billing. This can create Azure charges.
Try: “Set up standard billing for this container type.”
Write ·
billing_setupAllows the assistant to read and manage your files
Turns on opt-in consent for file read and manage operations.
Try: “Grant content access so you can search my containers.”
Write ·
content_access_grantUploads a file to a container
Uploads a file into a container.
Try: “Upload report.pdf to the Contract Files container.”
Write ·
content_file_uploadCreates a folder in a container
Creates a folder inside a container.
Try: “Create a folder called 2026 in Contract Files.”
Write ·
content_folder_createManages sharing on container content
Manages sharing settings for content.
Try: “Share the contract folder with the legal team.”
Write ·
content_sharing_manageManages who can access a container
Manages permissions on a container.
Try: “Give Alex read access to Contract Files.”
Write ·
container_permissions_manageArchives or restores a container
Archives a container or brings an archived one back.
Try: “Archive the old Contract Files container.”
Write ·
container_archive_restoreCreates a starter app from a reference design
Materializes a reference architecture, such as a React app with Functions or a C# web app, on your machine.
Try: “Scaffold a React app for my SharePoint Embedded project.”
Write ·
project_scaffoldFills in your app's config files
Writes .env, appsettings and azure.yaml files from your provisioning state.
Try: “Fill in the config files for my scaffolded app.”
Write ·
project_hydrate_configAdds sample containers and documents
Seeds sample containers and documents so you can try the app.
Try: “Seed some sample documents.”
Write ·
project_seed_sample_dataStarts the scaffolded app on your machine
Starts the scaffolded app locally.
Try: “Run my app locally.”
Runs code ·
project_run_localDeploys the app to Azure
Deploys with the Azure Developer CLI and returns the live URL. Deployment can run hooks from the project configuration.
Try: “Deploy my app to Azure.”
Runs code ·
project_deployWithdraws the assistant's file access
Turns off the opt-in consent for file operations.
Try: “Revoke content access.”
Write ·
content_access_revokeRemoves an owner from a container type
Revokes ownership of a container type. Marked beta in the README.
Try: “Remove this app as owner of the container type.”
Write ·
container_type_revoke_ownerStops an app from using a container type
Removes an application permission grant.
Try: “Remove my old app's access to this container type.”
Delete ·
container_type_app_grant_removeDeletes a container type
Deletes a container type.
Try: “Delete the trial container type.”
Delete ·
container_type_deleteDeletes a container
Deletes a container.
Try: “Delete the test container.”
Delete ·
container_deleteDeletes what the project created
Deletes the provisioned container type and the owning app. It asks for confirmation.
Try: “Clean up everything this project provisioned.”
Delete ·
project_cleanup
Read from the source code
Permissions
high risk · 5 things to watch
High risk
The assistant can create and delete container types, containers and the Entra app behind them, and billing set up can create Azure charges. Start with the read-only option until you know what you want it to change.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Preview software that can create Azure charges
Provisioning with standard billing registers a billing account in Azure. Use a test tenant first and read Microsoft's important notices. github.com
It can delete container types and containers
Delete and cleanup tools remove container types, containers and the owning app. Keep approval prompts on for these tools. github.com
Deploying can run project hooks
Deployment uses the Azure Developer CLI, which can run hooks from the project file. Review the project configuration before you approve a deploy. github.com
File access is opt-in
Reading and managing file content needs a separate grant that you can revoke. github.com
Sign-in tokens are cached on disk
Tokens are stored in a data folder in your home directory, and the README lets you move it with a data directory setting. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Start the server with the --read-only option to expose only read, list, get and search tools. The --tools option can also limit it to a profile such as readOnly or docsOnly. |
|---|---|
| Talks to | Microsoft Graph and Azure Resource Manager. Microsoft Learn MCP (documentation search). Microsoft (install labels in request headers, can be turned off) |
| Scopes |
|
Questions
How do I sign in?
Install the Azure CLI and run az login --allow-no-subscriptions once. The server uses that session and can create the owning Entra app for you. You can also bring your own app with a client ID and tenant ID.
Can it run read-only?
Yes. Add the read-only option when you start it and only read, list, get and search tools are exposed. A tools option can also limit it to a profile.
Will it cost money?
It can. Provisioning with standard billing registers a billing account in Azure, and Microsoft warns that provisioning can incur charges. A trial container type is also available.
Can it delete things?
Yes. It can delete container types, containers and the project it provisioned. Use read-only mode or approve each delete.
Which clients does it work with?
Microsoft names VS Code Copilot, Claude Desktop, Cursor and Azure Foundry. One-click install links exist for VS Code, VS Code Insiders, Visual Studio and Cursor.
Does it need Node.js?
Yes. The README asks for Node.js 22, 24 or 26.
How do I add it to Claude Code?
Use the install box above. The command includes the start subcommand, which the server needs.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@microsoft/spe-mcp- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 0.2.0-alpha.4
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 1
Other Microsoft SharePoint MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- SharePoint Embedded MCP server README · github.com