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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Related MCP Servers

MCP Filesystem Server
safurrier
-
security
A
license
-
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
5
Python
MIT License
MCP Toolkit
zxfgds
-
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
TypeScript
Filesystem MCP Server
QuantGeekDev
-
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 -
3
TypeScript
Filesystem MCP Server
cyanheads
-
security
A
license
-
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 -
160
3
TypeScript
Apache 2.0

View all related MCP servers

Proton Drive MCP

Proton Drive MCP

✨ Features

📋 Prerequisites

🚀 Quick Start

1. Install from npm (Recommended)

2. Or install from source

⚙️ Configuration

Finding your Proton Drive path

Claude Desktop

Cursor

Custom Proton Drive Path

🎯 Usage Examples

🛠️ Available Tools

🧪 Testing

🔧 Troubleshooting

Proton Drive not found

Permission errors

Tool not showing in Claude/Cursor

📝 Development

🤝 Contributing

📄 License

🔒 Security

🐛 Known Issues

📮 Support

Related MCP Servers

MCP Filesystem Server

MCP Toolkit

Filesystem MCP Server

Filesystem MCP Server

New MCP Servers

MCP directory API