proton-mail-bridge-client 2.1.43 → 2.1.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +16 -0
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -30,6 +30,22 @@ Give Claude Desktop (or Cline, or any MCP client) full access to your Proton Mai
30
30
 
31
31
  > **Battle-tested at scale (v2.0.0):** full mailbox backfill validated end-to-end against a real account with 57,000+ indexed messages across 62 folders/labels — including a 22,800-message Archive folder backfilled from scratch, UID-window by UID-window, with zero data loss across restarts, transient IMAP disconnects, and connection timeouts.
32
32
 
33
+ ## Quick start (2 minutes)
34
+
35
+ 1. **Install and sign in to [Proton Mail Bridge](https://proton.me/mail/bridge)**, and leave it running. In the Bridge app, open your account and copy the **Bridge password** (it is not your Proton password).
36
+ 2. **Connect Claude Desktop**, either way:
37
+ - **Bundle:** download the `proton-mail-bridge-client-<your-os>.mcpb` for macOS (`darwin-arm64`), Linux (`linux-x64`) or Windows (`win32-x64`) from the [latest release](https://github.com/googlarz/proton-mail-bridge-client/releases/latest) and open it. Claude Desktop asks for your Proton address and the Bridge password.
38
+ - **npm:** `npm install -g proton-mail-bridge-client`, then `proton-mail-bridge-client setup-claude-desktop` (it checks your Bridge ports and writes the config). Fully quit and reopen Claude Desktop afterwards.
39
+ 3. **Check it works:** run `proton-mail-bridge-client doctor`, or ask Claude "run the Proton Mail doctor".
40
+ 4. **Try these prompts:**
41
+ - "Give me a digest of my inbox and flag anything that needs a reply today."
42
+ - "Find the last email from `alice@example.com` and draft a reply for me to review." (nothing is sent until you say so)
43
+ - "Which of my emails have attachments from this month?"
44
+ - "Show me my drafts and tighten the oldest one."
45
+ 5. **Optional:** `PROTONMAIL_READ_ONLY=true` to browse without being able to change anything, `PROTONMAIL_TOOL_TIER=core` for a smaller tool set (25 instead of 96), and more accounts under [Multi-account support](#multi-account-support-v210). More recipes below in [Try it](#try-it-example-claude-prompts).
46
+
47
+ ---
48
+
33
49
  ## What you get
34
50
 
35
51
  - **Claude reads and manages your Proton Mail** — triage, reply, draft, archive, search, move, batch-act on threads, pull attachments
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "proton-mail-bridge-client",
3
- "version": "2.1.43",
3
+ "version": "2.1.44",
4
4
  "description": "Proton Mail Bridge Client — full-featured CLI and Claude Desktop MCP for Proton Mail via Proton Bridge. Read, search, send, draft, archive, manage folders, and more.",
5
5
  "mcpName": "io.github.googlarz/proton-mail-bridge-client",
6
6
  "type": "module",
@@ -36,7 +36,8 @@
36
36
  "ci": "npm run lint && npm test",
37
37
  "pack:check": "npm pack --dry-run",
38
38
  "release:check": "npm run lint && npm test && npm run pack:check",
39
- "package:mcpb": "node scripts/build-mcpb.mjs"
39
+ "package:mcpb": "node scripts/build-mcpb.mjs",
40
+ "version": "node scripts/sync-versions.mjs"
40
41
  },
41
42
  "keywords": [
42
43
  "protonmail",