MCP Server - Microsoft 365 File Search (SharePoint & OneDrive)
Overview
A Model Context Protocol (MCP) server implementation that provides advanced file search capabilities within Microsoft 365. This server enables efficient file discovery, metadata analysis, and integration with business workflows by making available the content from SharePoint/OneDrive.
https://github.com/user-attachments/assets/bbe63c02-f6d9-4c9b-8f98-36fc22a081cc
Components
Tools
The server offers 2 core tools:
-
search_m365_files
Perform a file search within the M365 environment.
Input:query(string): The search term or criteria.
Returns: Array of file metadata objects. Metadata includes the file content summary, drive ID, and file ID, among other details.
-
get_file_content
Retrieve content from a specific file.
Input:driveid(string): The unique identifier of the parent drive.fileid(string): The unique identifier of the file.
Returns: File content as a binary stream.
Note: Uses a local cache to speed up repeat access.
Caching
To improve performance and reduce redundant API calls, the server caches downloaded files locally. This is particularly useful when working with large documents or frequently accessed files.
- Cached files are stored in the
./src/mcp_m365_filesearch/.local/downloadsdirectory (relative to the project root). - When a file is requested via
get_file_content, the server first checks the cache. - If the file is already cached, it is returned directly from disk without a new API call.
This feature ensures faster response times and efficient use of API rate limits.
Usage with Claude Desktop
To integrate the server with Claude Desktop, update your claude_desktop_config.json:
"mcpServers": {
"M365 File Search (SharePoint/OneDrive)": {
"command": "uv",
"args": [
"--directory",
"full_path_to_parent_directory",
"run",
".\\src\\mcp_m365_filesearch\\server.py"
],
"env": {
"CLIENT_ID": "MSGraph Client ID",
"CLIENT_SECRET": "MS Graph Client Secret",
"TENANT_ID": "TENANT ID",
"REGION": "SEARCH REGION"
}
}
}
Microsoft Graph App Registration
To use this server, you'll need to register an application in the Azure Portal:
- Register a new application.
- Note down the Client ID and Tenant ID.
- Create a Client Secret under Certificates & Secrets.
- Under API permissions, add the following delegated or application permissions:
Sites.Read.AllFiles.Read.All
- Click Grant admin consent for these permissions.
Ensure these values are correctly set in your env configuration for the MCP server.
License
This project is licensed under the MIT License.
You are free to use, modify, and distribute it with proper attribution.
Metadata
Release files for iflow-mcp_godwin3737_mcp-m365-filesearch 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0.tar.gz | 7.8 kB | Without provenance | Details for iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0-py3-none-any.whl |
Total release size: 17.5 kB
Release files / iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0.tar.gz
| Download URL | iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0.tar.gz |
|---|---|
| Size | 7.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
411419d732462e77cc82e1e520f6d372baf3761fde0de7c8d978a05112db9f40
|
|
BLAKE2b-256 checksum How to use checksums |
536ee32ea42fdaf1f8c5682bb1c8c5a50928748e42dd16ebb315f1a74be9dfc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_godwin3737_mcp_m365_filesearch-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c8abd7725461269b3cd6bc705b90ed77a161f28155f885cf6a27a29b3870209c
|
|
BLAKE2b-256 checksum How to use checksums |
207f9140fd02e1e1ce9c58d54a83e7328974d58a559a12c079557ca1900fbc9c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_godwin3737_mcp-m365-filesearch 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.