Best for
- Users who need AI access to personal OneDrive files
- CLI enthusiasts
- Scenarios requiring strictly read-only access
O
OneDrive CLI
Community
Command line interface and read-only MCP server for OneDrive
GitHub source repository ↗
56FMRS · C
onedrive-cli offers a cross-platform CLI for OneDrive Personal and a read-only MCP server, suitable for AI access to cloud files. It does not support OneDrive for Business, and it's a community project, not official. Users should handle tokens securely and prefer read-only tokens to reduce risk.
onedrive-cli is a cross-platform command line tool for managing OneDrive (Personal). It also provides a read-only MCP server (over stdio) that lets MCP clients like Claude browse and read your OneDrive. The MCP server only issues GET requests and cannot modify the drive.
Tools
list_onedrive_folder
List direct children of a folder
search_onedrive_content
Full-text search across the whole drive
find_onedrive_files
Recursively find items by name glob
list_onedrive_albums
List photo albums or items in one album
read_onedrive_file
Read a file's contents as text
stat_onedrive_item
Return full metadata for an item
onedrive_storage
Report storage quota for the available drives
Setup
- Login to OneDrive: run
onedrive loginand follow the OAuth flow (recommendlogin -rfor read-only token). 2. Add the server configuration to your MCP client (e.g., Claude Desktop) viaclaude_desktop_config.jsonwithmcpServers. 3. The client will launchonedrive mcpautomatically.
claude_desktop_config.json
{
"mcpServers": {
"onedrive": {
"command": "onedrive",
"args": [
"mcp"
]
}
}
}
Fit and risk
Not for
- Write or modify scenarios
- OneDrive for Business (not supported)
- Enterprise-managed environments
Required permissions
- Requires OAuth access token (read-only recommended)
- Reads file contents, metadata, storage quota
- Does not modify or delete any files
Risks and side effects
- Token may be exposed, protect token file (~/.onedrive-cli-token)
- MCP server only GET, but underlying token might have extra permissions; use read-only token
- Upload not implemented, but other CLI commands can write; use read-only login for safety.
Troubleshooting
- Error 'Access token was not found; login first.': run `onedrive login` and complete OAuth.
- Token expires after 1 hour, re-login if needed.
- If MCP client fails to connect, ensure `onedrive` is in PATH and login was done.
- Verify JSON config file is valid.
Use cases
Let AI assistants browse and search your OneDrive files
Read documents, check storage usage
List albums and photos
Find files recursively
Supported clients
Claude DesktopFull support