Proton Mail (unofficial)

Package (npm 1.0.2)

npx -y proton-mail-mcp@1.0.2

Or add to your MCP client config:

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp@1.0.2"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "<YOUR_VALUE>",
        "PROTONMAIL_PASSWORD": "<YOUR_VALUE>",
        "PROTONMAIL_HOST": "<YOUR_VALUE>",
        "PROTONMAIL_PORT": "<YOUR_VALUE>",
        "PROTONMAIL_SECURE": "<YOUR_VALUE>",
        "IMAP_HOST": "<YOUR_VALUE>",
        "IMAP_PORT": "<YOUR_VALUE>",
        "IMAP_SECURE": "<YOUR_VALUE>",
        "IMAP_USERNAME": "<YOUR_VALUE>",
        "IMAP_PASSWORD": "<YOUR_VALUE>",
        "READONLY": "<YOUR_VALUE>",
        "RESTRICT_OUTBOUND_TO_SELF": "<YOUR_VALUE>",
        "ALLOW_FILE_DOWNLOAD_DIR": "<YOUR_VALUE>",
        "ALLOW_EMPTY_FOLDER": "<YOUR_VALUE>",
        "DEBUG": "<YOUR_VALUE>"
      }
    }
  }
}

• PROTONMAIL_USERNAME required — Your Proton Mail email address
• PROTONMAIL_PASSWORD required secret — Your Proton Mail SMTP password (not your login password; generate one in Proton settings)
• PROTONMAIL_HOST — SMTP host
• PROTONMAIL_PORT — SMTP port
• PROTONMAIL_SECURE — Use TLS for SMTP (true for port 465)
• IMAP_HOST — Proton Mail Bridge IMAP host (required for read/search tools)
• IMAP_PORT — Proton Mail Bridge IMAP port
• IMAP_SECURE — Use TLS for IMAP
• IMAP_USERNAME — Proton Mail Bridge username (falls back to PROTONMAIL_USERNAME)
• IMAP_PASSWORD secret — Proton Mail Bridge password (falls back to PROTONMAIL_PASSWORD)
• READONLY — Disable all mutating tools (send, move, delete, flags, labels, bulk ops, folder/label management)
• RESTRICT_OUTBOUND_TO_SELF — Refuse live sends to any recipient other than PROTONMAIL_USERNAME (for throwaway/QA accounts)
• ALLOW_FILE_DOWNLOAD_DIR — Allowlist directory enabling download_attachment.saveTo; when unset, attachments return as inline base64
• ALLOW_EMPTY_FOLDER — Register the empty_folder tool (not recommended)
• DEBUG — Enable verbose logging to stderr