Proton Drive Cli Mcp

by borealstack

254 downloads

Not rated

GitHub

About

Proton Drive CLI MCP server and Codex/Claude-ready metadata for the official Proton Drive CLI

Details

Author: borealstack
Downloads: 254
Categories: File Management, Security, Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Proton Drive Cli Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

From the repository

—

`proton_drive_diagnose`

Check CLI discovery, managed install status, version, PATH status, authentication, and the next setup action.

`proton_drive_setup`

Install the official CLI if needed, then diagnose CLI discovery, PATH status, version, and authentication.

`proton_drive_auth_status`

Check whether the Proton Drive CLI can access the logged-in account.

`proton_drive_auth_login`

Start the official Proton Drive CLI browser login flow and return quickly instead of waiting for login completion.

`proton_drive_auth_login_status`

Inspect the background Proton Drive CLI login process started by proton_drive_auth_login.

`proton_drive_auth_login_cancel`

Cancel the background Proton Drive CLI login process started by proton_drive_auth_login.

`proton_drive_auth_logout`

Log out the official Proton Drive CLI from the current OS user.

`proton_drive_cli_install`

Download the latest official Proton Drive CLI for this system, verify Proton's SHA-512 checksum, and install it to a user-local managed path.

`proton_drive_cli_version`

Show the Proton Drive CLI and SDK versions.

`proton_drive_cli_help`

Show help for the root CLI or a supported command.

`proton_drive_list`

List children under a Proton Drive path with bounded output to keep responses manageable.

`proton_drive_list_async`

Start a background folder listing job and return a job ID for status polling.

`proton_drive_info`

Get metadata for a Proton Drive file or folder.

`proton_drive_create_folder`

Create a folder under a Proton Drive parent path.

`proton_drive_upload`

Upload one or more local files or folders to a Proton Drive parent path.

`proton_drive_upload_async`

Start a background upload job and return a job ID for status polling or cancellation.

`proton_drive_download`

Download one or more Proton Drive paths into a local folder.

`proton_drive_download_async`

Start a background download job and return a job ID for status polling or cancellation.

`proton_drive_job_status`

Inspect one background list, upload, or download job, or list retained jobs when no job ID is provided.

`proton_drive_job_cancel`

Cancel a running background list, upload, or download job.

`proton_drive_read_text`

Download one small Proton Drive file to a temporary directory, reject binary or oversized content, and return UTF-8 text.

`proton_drive_write_text`

Write a small UTF-8 text file through a temporary local file and upload it to Proton Drive.

`proton_drive_rename`

Rename a Proton Drive file or folder.

`proton_drive_copy`

Copy one or more Proton Drive nodes into a target parent folder.

`proton_drive_move`

Move one or more Proton Drive nodes into a target parent folder.

`proton_drive_trash`

Move Proton Drive files or folders to trash.

`proton_drive_restore`

Restore Proton Drive files or folders from trash.

`proton_drive_delete`

Permanently delete Proton Drive files or folders. This cannot be undone.

`proton_drive_empty_trash`

Permanently delete everything in Proton Drive trash. This cannot be undone.

`proton_drive_sharing_status`

Show sharing status for a Proton Drive path.

`proton_drive_sharing_invite`

Invite Proton users to a shared Proton Drive path.

`proton_drive_sharing_remove`

Remove one or all user invitations/access entries from a Proton Drive path.

`proton_drive_sharing_set_url`

Create or update a public sharing URL for a Proton Drive path. Custom link passwords are intentionally not accepted because the official CLI currently exposes them as command-line arguments.

`proton_drive_sharing_remove_url`

Remove a public sharing URL from a Proton Drive path.

`proton_drive_invitation_list`

List pending Proton Drive invitations.

`proton_drive_invitation_accept`

Accept a Proton Drive invitation by UID.

`proton_drive_invitation_reject`

Reject a Proton Drive invitation by UID.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "proton drive cli mcp": {
            "proton-drive": {
                "command": "npx",
                "args": [
                    "-y",
                    "@borealstack/proton-drive-cli-mcp"
                ],
                "env": []
            }
        }
    }
}

McpServers

{
    "proton-drive": {
        "command": "npx",
        "args": [
            "-y",
            "@borealstack/proton-drive-cli-mcp"
        ],
        "env": []
    }
}

Manage Proton Drive from Claude, Codex, VS Code/Copilot, and any MCP client through Proton's official CLI. Authentication and encrypted Drive behavior stay with Proton's tooling.

AI agents can already run shell commands, but Drive operations should not depend on prompt-crafted command lines. This server exposes Proton Drive as typed MCP tools while delegating the sensitive parts to Proton's officialproton-driveCLI.

[!NOTE] This project is an independent interoperability wrapper. It is not affiliated with Proton AG.

Add the server to an MCP client as a local stdio server:

{ "mcpServers": { "proton-drive": { "command": "npx", "args": ["-y", "@borealstack/proton-drive-cli-mcp"], "env": {} } } }

The command is a stdio server. If you run it directly in a terminal, no prompt or banner is expected; it waits for MCP JSON-RPC messages on stdin.

Start with diagnosis. The server will report whether the official CLI is found, whether the managed install path exists, which version is available, and whether the CLI can access/my-files.

Call proton_drive_setup with installIfMissing=true

If authentication is missing, start the browser login flow:

Call proton_drive_auth_login Finish Proton sign-in in the browser Call proton_drive_diagnose again

[!TIP] The server does not request or store Proton credentials. Login, session storage, and encrypted Drive behavior remain delegated to Proton's official CLI.

- Node.js 22+ for the published package.
- Bun 1.3+ for repository development and Bun test coverage.
- The official Proton Drive CLI, or network access to Proton's CLI download index for managed install.
- Browser access for the official Proton login flow.
- PROTON_DRIVE_CLI_PATH
- The managed user-local install path
- proton-driveorproton-drive.exein the current directory or common download paths
- proton-driveonPATH
- Managed install from Proton's CLI download index

Full schemas and examples are indocs/TOOLS.md.

List the top 20 items in /my-files/Reports.

Usesproton_drive_listwith bounded output and pagination metadata.

Upload these local files to /my-files/Reports, then poll until done.

Usesproton_drive_upload_asyncfollowed byproton_drive_job_status.

Read /my-files/Notes/todo.txt, update the text, and write it back.

Usesproton_drive_read_textandproton_drive_write_textfor small UTF-8 files. Full binary or large-file work should useproton_drive_downloadandproton_drive_upload.

This project is designed so the MCP layer can orchestrate Drive work without becoming a credential broker.

[!IMPORTANT]proton_drive_deleteandproton_drive_empty_trashare permanent operations. Preferproton_drive_trashfirst unless the user explicitly asks to delete.

- npm package tarball
- MCPB bundle
- SHA256SUMS
- Sigstore JSON attestation bundle

bun install bun run typecheck bun test bun run build npm test

{ "mcpServers": { "proton-drive-dev": { "command": "bun", "args": ["run", "<path-to-repo>/src/index.ts"], "env": {} } } }

Run real-account smoke checks only when you intentionally want to touch a logged-in Proton Drive account. Keep generated smoke artifacts local and out of git.

- Proton: Using Proton Drive CLI
- Proton blog: Introducing Proton Drive CLI
- Official Proton Drive CLI README
- Model Context Protocol TypeScript SDK

If this project helps you connect Proton Drive to an MCP client, star the repository so other users can find the maintained official-CLI wrapper:borealstack/proton-drive-cli-mcp.

Upload, retrieve, pin, and manage encrypted files on IPFS via a simple API accessible as MCP tools

Ephemeral encrypted file sharing for AI. Client-side AES-256 encryption, 24h auto-vaporization.

An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.

A secure server for filesystem operations with controlled access to specified directories.

Provides access to an FTP server for file operations.

Kobel is a local Windows permission gateway that controls which files ChatGPT, Claude & other AI tools may access — 100% local, no cloud.

Provides secure access to the local filesystem via the Model Context Protocol (MCP).

A server for secure, sandboxed file system operations.

An MCP server that gives any MCP client read access to an SMB/CIFS file share servers

A secure MCP server for accessing the local filesystem within predefined directories.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

proton_drive_diagnose

proton_drive_setup

proton_drive_auth_status

proton_drive_auth_login

proton_drive_auth_login_status

proton_drive_auth_login_cancel

proton_drive_auth_logout

proton_drive_cli_install

proton_drive_cli_version

proton_drive_cli_help

proton_drive_list

proton_drive_list_async

proton_drive_info

proton_drive_create_folder

proton_drive_upload

proton_drive_upload_async

proton_drive_download

proton_drive_download_async

proton_drive_job_status

proton_drive_job_cancel

proton_drive_read_text

proton_drive_write_text

proton_drive_rename

proton_drive_copy

proton_drive_move

proton_drive_trash

proton_drive_restore

proton_drive_delete

proton_drive_empty_trash

proton_drive_sharing_status

proton_drive_sharing_invite

proton_drive_sharing_remove

proton_drive_sharing_set_url

proton_drive_sharing_remove_url

proton_drive_invitation_list

proton_drive_invitation_accept

proton_drive_invitation_reject

Claude Desktop / Cursor

McpServers

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`proton_drive_diagnose`

`proton_drive_setup`

`proton_drive_auth_status`

`proton_drive_auth_login`

`proton_drive_auth_login_status`

`proton_drive_auth_login_cancel`

`proton_drive_auth_logout`

`proton_drive_cli_install`

`proton_drive_cli_version`

`proton_drive_cli_help`

`proton_drive_list`

`proton_drive_list_async`

`proton_drive_info`

`proton_drive_create_folder`

`proton_drive_upload`

`proton_drive_upload_async`

`proton_drive_download`

`proton_drive_download_async`

`proton_drive_job_status`

`proton_drive_job_cancel`

`proton_drive_read_text`

`proton_drive_write_text`

`proton_drive_rename`

`proton_drive_copy`

`proton_drive_move`

`proton_drive_trash`

`proton_drive_restore`

`proton_drive_delete`

`proton_drive_empty_trash`

`proton_drive_sharing_status`

`proton_drive_sharing_invite`

`proton_drive_sharing_remove`

`proton_drive_sharing_set_url`

`proton_drive_sharing_remove_url`

`proton_drive_invitation_list`

`proton_drive_invitation_accept`

`proton_drive_invitation_reject`