sharepoint-online-mcp

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