proton_drive_diagnoseLABSCO SUMMARY
Destructive tools stop and ask.
Anything that removes data or changes the account — trash, delete, empty trash, logout, removing a share — refuses to run unless the call carries confirm: true, which turns an ambiguous instruction into a second explicit step rather than a lost file. The other design choice worth knowing about is that folder listings and job output come back bounded, with counts and a truncated flag, so pointing an assistant at a large Drive does not dump the whole tree into context.
What it is
A stdio server that exposes Proton Drive as schema-checked tools instead of prompt-written command lines. Every operation runs through Proton's official proton-drive CLI, so authentication, session storage and the encrypted Drive behaviour are Proton's code, not a reimplementation. It is an independent wrapper, not a Proton product.
What you get
proton_drive_list,proton_drive_infoandproton_drive_create_folderbrowse and build the tree, with list output bounded and pagedproton_drive_uploadandproton_drive_downloadmove files, withproton_drive_upload_asyncandproton_drive_download_asyncreturning a job id instead of blockingproton_drive_job_statusandproton_drive_job_cancelfollow or stop a background jobproton_drive_read_textandproton_drive_write_textread and write small UTF-8 files directly, rejecting binary or oversized contentproton_drive_rename,proton_drive_copy,proton_drive_move,proton_drive_trash,proton_drive_restoreandproton_drive_deletereorganise and removeproton_drive_sharing_invite,proton_drive_sharing_status,proton_drive_sharing_set_urlandproton_drive_sharing_removehandle people and public linksproton_drive_diagnoseandproton_drive_setupreport CLI discovery, version, PATH and auth state, and install what is missing
Requirements
Node.js 22+ and the official Proton Drive CLI. Run it as npx -y @borealstack/proton-drive-cli-mcp (package @borealstack/proton-drive-cli-mcp, version 0.1.2) over stdio. If the CLI is missing the server downloads the current official build for your OS and CPU and verifies Proton's SHA-512 checksum before using it; set PROTON_DRIVE_CLI_PATH to point at your own copy, or PROTON_DRIVE_CLI_AUTO_INSTALL=0 to switch that off. Sign-in happens in the browser through the CLI and the session lands in the OS secret store — this server never sees or stores Proton credentials.
Setup effort
One command — npx -y @borealstack/proton-drive-cli-mcp
USE CASES
Finding and reading a document in Drive
Browse the folder, check what a path is, then pull a small text file back as UTF-8.
Filing a batch of local files without waiting
Start the upload as a background job and check on it by id when you want.
Sharing a folder with a colleague
Invite them by email with a role, or set a public link with an expiry date.
Getting connected in the first place
Diagnose what is missing, install the official CLI, and start the browser sign-in.
37 tools
Listed in project docs. Your client may show a different list.
proton_drive_setupproton_drive_auth_statusproton_drive_auth_loginproton_drive_auth_login_statusproton_drive_auth_login_cancelproton_drive_auth_logoutproton_drive_cli_installproton_drive_cli_versionproton_drive_cli_helpproton_drive_listproton_drive_infoproton_drive_create_folderproton_drive_uploadproton_drive_downloadproton_drive_list_asyncproton_drive_upload_asyncproton_drive_download_asyncproton_drive_job_statusproton_drive_job_cancelproton_drive_read_textproton_drive_write_textproton_drive_renameproton_drive_copyproton_drive_moveproton_drive_trashproton_drive_restoreproton_drive_deleteproton_drive_empty_trashproton_drive_sharing_statusproton_drive_sharing_inviteproton_drive_sharing_removeproton_drive_sharing_set_urlproton_drive_sharing_remove_urlproton_drive_invitation_listproton_drive_invitation_acceptproton_drive_invitation_rejectBEFORE YOU INSTALL
What to know first
Tools you get
37 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 22+
INSTALLATION
Connect your client
Server setup
Any MCP client — npx
npx -y @borealstack/proton-drive-cli-mcpMCP Clients
Claude Code
claude mcp add --transport stdio proton-drive -- npx -y @borealstack/proton-drive-cli-mcpClaude Desktop
{
"mcpServers": {
"proton-drive": {
"command": "npx",
"args": [
"-y",
"@borealstack/proton-drive-cli-mcp"
],
"env": {}
}
}
}VS Code
code --add-mcp "{\"name\":\"proton-drive\",\"command\":\"npx\",\"args\":[\"-y\",\"@borealstack/proton-drive-cli-mcp\"]}"