proton-drive-mcp 1.0.21 → 1.0.23

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.0.23 — 2026-06-10
+
+### Fixed
+- **README** — "14 operations" corrected to 18; Node.js requirement updated to 20+ in text and badge
+- **`smithery.yaml`** — `commandFunction` now forwards `PROTON_DRIVE_SYNC_PATH` env var from config to the process
+
+## 1.0.22 — 2026-06-10
+
+### Fixed
+- **CI Node 20 deprecation** — publish workflow bumped to Node 22; CI matrix updated to [20, 22, 24] (drops EOL Node 18, adds Node 24)
+- **`engines` field** — bumped from `>=18` to `>=20` (Node 18 is EOL since April 2025)
+- **`smithery.yaml`** — added missing `drive_read_file` and `drive_write_file` tools; added `PROTON_DRIVE_SYNC_PATH` to configSchema
+- **README** — added Local sync tool group, two missing tools in reference table, `PROTON_DRIVE_SYNC_PATH` env var documentation
+
+### Added
+- **MCP dispatch layer tests** — confirmed-gate coverage for `drive_delete` and `drive_empty_trash`; env-var-guard coverage for `drive_read_file` (88 tests total)
+
 ## 1.0.21 — 2026-06-10
 
 ### Improved

package/README.md

@@ -12,7 +12,7 @@
 [![npm version](https://img.shields.io/npm/v/proton-drive-mcp?color=%236d4aff&label=npm)](https://www.npmjs.com/package/proton-drive-mcp)
 [![CI](https://github.com/googlarz/proton-drive-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/googlarz/proton-drive-mcp/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![Node.js 20+](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
 [![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)
 [![GitHub stars](https://img.shields.io/github/stars/googlarz/proton-drive-mcp?style=social)](https://github.com/googlarz/proton-drive-mcp)
@@ -29,7 +29,7 @@ Give Claude Desktop (or any MCP client) full access to your Proton Drive: list f
 ## What you get
 
 - **Claude manages your Proton Drive** — list, upload, download, move, share, trash, restore
-- **Full CLI** — same 14 operations, scriptable and pipeable, works in cron and shell scripts
+- **Full CLI** — same 18 operations, scriptable and pipeable, works in cron and shell scripts
 - **Zero credential exposure** — auth is handled entirely by the official Proton Drive CLI; this MCP never touches your password or session token
 - **Shell injection safe** — all CLI calls use `execFile` with discrete argument arrays, never string interpolation
 - **Privacy-native** — end-to-end encryption is handled by Proton's own CLI; this server is just a thin MCP wrapper
@@ -58,7 +58,7 @@ proton-drive auth login
 
 This opens a browser for Proton's standard sign-in flow. Credentials are stored in your OS keychain — not on disk, not in config files.
 
-**3. Node.js 18 or later** — `node --version` to check.
+**3. Node.js 20 or later** — `node --version` to check.
 
 ---
 
@@ -222,6 +222,9 @@ proton-drive-cli share status /my-files/Projects
 ### Trash
 `drive_list_trash` · `drive_trash` · `drive_restore` · `drive_empty_trash`
 
+### Local sync (requires `PROTON_DRIVE_SYNC_PATH`)
+`drive_read_file` · `drive_write_file`
+
 ---
 
 ## Tool reference
@@ -244,6 +247,8 @@ proton-drive-cli share status /my-files/Projects
 | `drive_trash` | Move to trash | `path` |
 | `drive_restore` | Restore from trash | `path` |
 | `drive_empty_trash` | Permanently delete all trash ⚠️ | `confirmed: true` |
+| `drive_read_file` | Read text file from local sync folder | `path` |
+| `drive_write_file` | Write text file to local sync folder ⚠️ | `path`, `content` |
 
 > ⚠️ **Destructive tools** require `confirmed: true`. Use `drive_list_trash` first so you know what will be deleted, then pass `confirmed: true` to proceed.
 
@@ -271,8 +276,20 @@ proton-drive-cli share status /my-files/Projects
 
 ---
 
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `PROTON_DRIVE_SYNC_PATH` | Optional | Absolute path to your local Proton Drive sync folder root (e.g. `/Users/you/Proton Drive`). Required only for `drive_read_file` and `drive_write_file`. The Proton Drive desktop app must be running to sync written files to the cloud. |
+| `PROTON_DRIVE_BIN` | Optional | Override the `proton-drive` binary name or path (default: `proton-drive`). Useful for non-standard installations. |
+
+---
+
 ## Troubleshooting
 
+**"PROTON_DRIVE_SYNC_PATH is not set"**  
+Add `"PROTON_DRIVE_SYNC_PATH": "/absolute/path/to/your/Proton Drive"` to your Claude Desktop MCP config env block. The path must point to the root folder that the Proton Drive desktop app syncs to.
+
 **"proton-drive CLI not found"**  
 Download from [proton.me/download/drive/cli](https://proton.me/download/drive/cli/index.html) and ensure the binary is in your `PATH`. Verify with `which proton-drive`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proton-drive-mcp",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "MCP server and CLI that gives Claude full access to Proton Drive — upload, download, share, and manage your end-to-end encrypted files without leaving the conversation.",
   "type": "module",
   "main": "dist/index.js",
@@ -51,7 +51,7 @@
     "url": "https://github.com/googlarz/proton-drive-mcp/issues"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.11.0"

package/smithery.yaml

@@ -28,10 +28,19 @@ tools:
   - drive_trash
   - drive_restore
   - drive_empty_trash
+  - drive_read_file
+  - drive_write_file
 startCommand:
   type: stdio
   configSchema:
     type: object
-    properties: {}
+    properties:
+      PROTON_DRIVE_SYNC_PATH:
+        type: string
+        description: "Absolute path to the root of your local Proton Drive sync folder. Required only for drive_read_file and drive_write_file. Example: /Users/you/Proton Drive"
   commandFunction: |-
-    (_config) => ({ command: "npx", args: ["-y", "proton-drive-mcp"] })
+    (config) => ({
+      command: "npx",
+      args: ["-y", "proton-drive-mcp"],
+      env: config.PROTON_DRIVE_SYNC_PATH ? { PROTON_DRIVE_SYNC_PATH: config.PROTON_DRIVE_SYNC_PATH } : {}
+    })