适合谁
- 需要 AI 访问 OneDrive 个人文件的用户
- 喜欢命令行工具集成的人群
- 对只读访问有严格要求的场景
O
56FMRS · C
onedrive-cli 提供了一个跨平台的 OneDrive 个人版命令行接口，并附带一个只读 MCP 服务器，适合需要 AI 访问云文件（如文档、图片）的用户。它不支持 OneDrive for Business，并且是社区项目而非官方微软产品。使用前需注意令牌安全，并仅使用只读令牌以降低风险。
onedrive-cli 是一个跨平台的命令行工具，用于管理 OneDrive（个人版）文件。它还提供了一个只读的 MCP 服务器（通过 stdio 运行），使 MCP 客户端（如 Claude）可以浏览和读取您的 OneDrive 内容。该 MCP 服务器仅发出 GET 请求，不会修改您的云端文件。
工具能力
list_onedrive_folder
列出文件夹的直接子项
search_onedrive_content
在整个驱动器中执行全文搜索
find_onedrive_files
按名称通配符递归查找项目
list_onedrive_albums
列出相册或相册中的项目
read_onedrive_file
以文本形式读取文件内容
stat_onedrive_item
返回项目的完整元数据
onedrive_storage
报告可用驱动器的存储配额
安装接入
- 登录 OneDrive：运行
onedrive login，按照提示完成 OAuth 授权（建议使用login -r获取只读令牌）。2. 在 MCP 客户端（如 Claude Desktop）配置文件中添加服务器配置，例如claude_desktop_config.json中的mcpServers。3. 配置后，MCP 客户端会自动启动onedrive mcp进行通信。
claude_desktop_config.json
{
"mcpServers": {
"onedrive": {
"command": "onedrive",
"args": [
"mcp"
]
}
}
}
选型与风险
不适合谁
- 需要写入或修改 OneDrive 环境的场景
- OneDrive for Business 用户（尚未支持）
- 需要管理员审批或企业策略的管理场景
所需权限
- 需要 OAuth 访问令牌（建议只读范围）
- 读取文件内容、元数据和存储配额
- 不会修改或删除任何文件
风险与副作用
- 令牌可能被泄露，令牌文件路径（~/.onedrive-cli-token）需妥善保护
- MCP 服务器仅发出 GET 请求，但底层访问令牌可能具有额外权限，确保只读令牌
- 上传功能尚未实现，但其他命令（如 cp）可以有写权限，注意使用 read-only 登录
常见排障
- 错误“Access token was not found; 'login' first.”：请先运行 `onedrive login` 并完成授权。
- 检查令牌是否过期（有效期为 1 小时），可重新登录。
- 如果 MCP 客户端无法连接，请确保 `onedrive` 命令在 PATH 中，并且已先完成登录。
- 确保配置文件 JSON 格式正确。
使用场景
允许 AI 助手浏览和搜索您的 OneDrive 文件内容
读取文档、统计存储使用情况
列出相册和照片
递归查找文件
支持客户端
Claude Desktop完整支持