Proton Drive MCP

🚀 Proton Drive MCP

A Model Context Protocol (MCP) server that allows AI assistants such as 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 - Operates through the local filesystem, no credentials required.
• 🚀 Easy to install - Just run 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 attempt 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