Skip to main content
Glama

Proton Drive MCP

by anyrxo

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

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:

ToolDescription
check_mountVerify Proton Drive is accessible
list_filesList contents of a directory
read_fileRead file contents
write_fileCreate or overwrite files
delete_fileRemove files or folders
create_folderCreate 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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

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

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

                        • -
                          security
                          F
                          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 -
                          16
                          1
                          TypeScript
                        • -
                          security
                          F
                          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 -
                          263
                          6
                          TypeScript
                          • Apple
                        • A
                          security
                          A
                          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
                          255
                          14
                          TypeScript
                          Apache 2.0
                        • -
                          security
                          A
                          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.
                          Last updated -
                          Python
                          MIT License

                        View all related 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