sharepoint-online-mcp
Zero-config MCP server for SharePoint Online that enables managing sites, pages, navigation, and branding via natural language, with automatic device code authentication and no Azure registration required.
README
SharePoint Online MCP Server
MCP server for SharePoint Online — zero-config, no Azure Portal, no env vars.
Quick Start
Install and run:
npx sharepoint-online-mcp
Add to Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"sharepoint": {
"command": "npx",
"args": ["-y", "sharepoint-online-mcp"]
}
}
}
No environment variables needed. That's the entire setup.
How It Works
- Uses the Microsoft Office well-known client ID — no Azure app registration needed
- On first use, prompts for device code authentication (open a URL, enter a code)
- Auto-discovers your tenant ID from the SharePoint URL
- Caches tokens in
~/.sharepoint-mcp-cache.json— persists across restarts
Usage
Start by asking Claude to connect to your SharePoint site:
"Connect to https://contoso.sharepoint.com/sites/marketing"
Claude will handle the authentication prompts. Once connected, use any tool — search sites, create pages, manage navigation, and more.
Tools
| Category | Tool | Description |
|---|---|---|
| Sites | search_sites |
Search for SharePoint sites by keyword |
get_site_details |
Get detailed information about a site | |
get_site_by_url |
Resolve a site from its SharePoint URL | |
connect_to_site |
Connect to a site (auto tenant discovery + auth) | |
list_my_sites |
List sites you follow | |
| Pages | list_pages |
List pages in a site |
get_page |
Get page content and metadata | |
create_page |
Create a new modern page | |
update_page |
Update page title or description | |
publish_page |
Publish a draft page | |
delete_page |
Delete a page | |
| Layout | add_section |
Add a section with column layout |
get_page_layout |
Get the layout structure of a page | |
| Web Parts | add_text_webpart |
Add a text/HTML web part |
add_image_webpart |
Add an image web part | |
add_spacer |
Add a spacer web part | |
add_divider |
Add a divider web part | |
add_custom_webpart |
Add any web part by type ID | |
| Navigation | get_navigation |
Get Quick Launch or Top Navigation |
add_navigation_link |
Add a navigation link | |
remove_navigation_link |
Remove a navigation link | |
| Branding | set_site_logo |
Set the site logo |
upload_asset |
Upload a file to Site Assets | |
| Utility | get_design_templates |
List available site design templates |
disconnect |
Clear auth tokens and disconnect |
Requirements
- Node.js >= 18
- A Microsoft 365 / SharePoint Online account
Known Limitations
- Some organizations block device code authentication via Conditional Access policies. If you see error
AADSTS50076orAADSTS53003, contact your IT administrator. - Only works with SharePoint Online (Microsoft 365), not on-premises SharePoint Server.
- Permissions depend on your Microsoft 365 account — you can only access sites you have permission to.
Troubleshooting
| Problem | Solution |
|---|---|
| Authentication failed | Run the disconnect tool and try again |
| Tenant discovery failed | Check that the SharePoint URL is correct and accessible |
| Access denied (403) | Your account may not have permission for this site or operation |
| Resource not found (404) | Verify the site URL, page ID, or resource exists |
| Token issues | Delete ~/.sharepoint-mcp-cache.json and re-authenticate |
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.