Skip to main content
Glama

Proton Drive MCP

by anyrxo
README.mdโ€ข4.54 kB
# 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) ```bash npm install -g proton-drive-mcp ``` ### 2. Or install from source ```bash 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` ```json { "mcpServers": { "proton-drive": { "command": "node", "args": ["path/to/proton-drive-mcp/dist/index.js"] } } } ``` ### Cursor Add to your Cursor settings: ```json { "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: ```json { "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: ```bash # 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 ```bash # 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](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 - Issues: [GitHub Issues](https://github.com/anyrxo/proton-drive-mcp/issues) - Discussions: [GitHub Discussions](https://github.com/anyrxo/proton-drive-mcp/discussions) --- Made with โค๏ธ for the Proton Drive community

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