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 AADSTS50076 or AADSTS53003, 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

sharepoint-online-mcp