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

Make sure Proton Drive desktop app is running
Check if your files are synced
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

Restart your AI client after configuration
Check the logs for any error messages
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:

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
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

Issues: GitHub Issues
Discussions: GitHub Discussions

Made with ❤️ for the Proton Drive community