Skip to main content
Glama

Proton Drive MCP

by anyrxo
GitHub
JavaScript
MIT License
2
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Proton Drive MCP

A Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients to interact with your Proton Drive files.

โœจ Features

  • ๐Ÿ“ List files and folders in your Proton Drive

  • ๐Ÿ“„ Read file contents directly

  • โœ๏ธ Create and write files to Proton Drive

  • ๐Ÿ—‘๏ธ Delete files and folders

  • ๐Ÿ“‚ Create new folders

  • ๐Ÿ”„ Cross-platform support (Windows, macOS, Linux)

  • ๐Ÿ”’ Secure - Works through local filesystem, no credentials needed

  • ๐Ÿš€ Easy to install - Just npm install and configure

๐Ÿ“‹ Prerequisites

  • Node.js 16 or higher

  • Proton Drive desktop app installed and synced

  • Claude Desktop, Cursor, or any MCP-compatible client

๐Ÿš€ Quick Start

1. Install from npm (Recommended)

npm install -g proton-drive-mcp

2. Or install from source

git clone https://github.com/anyrxo/proton-drive-mcp.git cd proton-drive-mcp npm install npm run build

โš™๏ธ Configuration

Finding your Proton Drive path

The MCP will try to auto-detect your Proton Drive location, but you can also set it manually:

  • macOS: ~/Library/CloudStorage/ProtonDrive-[email]-folder

  • Windows: C:\Users\[username]\Proton Drive

  • Linux: ~/ProtonDrive

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "proton-drive": { "command": "node", "args": ["path/to/proton-drive-mcp/dist/index.js"] } } }

Cursor

Add to your Cursor settings:

{ "mcp.servers": { "proton-drive": { "command": "node", "args": ["path/to/proton-drive-mcp/dist/index.js"] } } }

Custom Proton Drive Path

If your Proton Drive is in a non-standard location:

{ "mcpServers": { "proton-drive": { "command": "node", "args": ["path/to/proton-drive-mcp/dist/index.js"], "env": { "PROTON_DRIVE_PATH": "/custom/path/to/ProtonDrive" } } } }

๐ŸŽฏ Usage Examples

Once configured, you can ask your AI assistant:

  • "List all files in my Proton Drive"

  • "Create a new file called notes.txt with some content"

  • "Read the contents of Documents/report.pdf"

  • "Create a new folder called Projects"

  • "Delete the file old-notes.txt"

๐Ÿ› ๏ธ Available Tools

The MCP provides these tools:

Tool

Description

check_mount

Verify Proton Drive is accessible

list_files

List contents of a directory

read_file

Read file contents

write_file

Create or overwrite files

delete_file

Remove files or folders

create_folder

Create new directories

๐Ÿงช Testing

Test if the MCP is working:

# Check if Proton Drive is detected npm run test:connection # Run all tests npm test

๐Ÿ”ง Troubleshooting

Proton Drive not found

  1. Make sure Proton Drive desktop app is running

  2. Check if your files are synced

  3. Set PROTON_DRIVE_PATH environment variable manually

Permission errors

  • Ensure the MCP has read/write access to your Proton Drive folder

  • On macOS, you may need to grant permissions in System Preferences

Tool not showing in Claude/Cursor

  1. Restart your AI client after configuration

  2. Check the logs for any error messages

  3. Verify the path to the MCP is correct

๐Ÿ“ Development

# Install dependencies npm install # Run in development mode npm run dev # Build for production npm run build # Run tests npm test

๐Ÿค Contributing

Contributions are welcome! Please:

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

๐Ÿ“„ License

MIT License - see LICENSE file

๐Ÿ”’ Security

  • All operations are performed locally on your filesystem

  • No data is sent to external servers

  • Proton's end-to-end encryption is preserved

  • Path validation prevents directory traversal attacks

๐Ÿ› Known Issues

  • Large files (>10MB) may take time to read

  • Binary files are not supported for reading (yet)

  • Some special characters in filenames may cause issues

๐Ÿ“ฎ Support

Made with โค๏ธ for the Proton Drive community

Deploy Server
A
security โ€“ no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Model Context Protocol server that enables AI assistants to interact with Proton Drive files, supporting operations like listing, reading, creating, and deleting files and folders.

  1. โœจ Features
    1. ๐Ÿ“‹ Prerequisites
      1. ๐Ÿš€ Quick Start
        1. 1. Install from npm (Recommended)
        2. 2. Or install from source
      2. โš™๏ธ Configuration
        1. Finding your Proton Drive path
        2. Claude Desktop
        3. Cursor
        4. Custom Proton Drive Path
      3. ๐ŸŽฏ Usage Examples
        1. ๐Ÿ› ๏ธ Available Tools
          1. ๐Ÿงช Testing
            1. ๐Ÿ”ง Troubleshooting
              1. Proton Drive not found
              2. Permission errors
              3. Tool not showing in Claude/Cursor
            2. ๐Ÿ“ Development
              1. ๐Ÿค Contributing
                1. ๐Ÿ“„ License
                  1. ๐Ÿ”’ Security
                    1. ๐Ÿ› Known Issues
                      1. ๐Ÿ“ฎ Support

                        Related MCP Servers

                        • MCP Toolkit

                          zxfgds
                          -
                          security
                          -
                          license
                          -
                          quality
                          A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                          Last updated -
                          36
                          1

                        • Filesystem MCP Server

                          QuantGeekDev
                          -
                          security
                          -
                          license
                          -
                          quality
                          A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
                          Last updated -
                          418
                          6
                          • Apple

                        • Filesystem MCP Server

                          cyanheads
                          A
                          security
                          -
                          license
                          A
                          quality
                          A Model Context Protocol server that provides AI agents with secure access to local filesystem operations, enabling reading, writing, and managing files through a standardized interface.
                          Last updated -
                          10
                          35
                          21
                          Apache 2.0

                        • MCP File System Server

                          -
                          security
                          -
                          license
                          -
                          quality
                          A simple Model Context Protocol server that enables AI assistants to interact with local file systems, allowing them to read, write, update, and delete files within a specified project directory.

                        View all related MCP servers

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/anyrxo/proton-drive-mcp'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server