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

Related MCP server: Filesystem MCP Server

📋 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:

🧪 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

• Issues: GitHub Issues

• Discussions: GitHub Discussions

Made with ❤️ for the Proton Drive community