io.github.sethbang

proton-mail-mcp

Proton Mail (unofficial)

Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP

stdiocommunityservice

Package Details

proton-mail-mcp

1.0.2•https://www.npmjs.com/package/proton-mail-mcp
Transportstdio
Runtimenpx

Environment Variables

PROTONMAIL_USERNAME
Required

Your Proton Mail email address

PROTONMAIL_PASSWORD
RequiredSecret

Your Proton Mail SMTP password (not your login password; generate one in Proton settings)

PROTONMAIL_HOST
Default:smtp.protonmail.ch

SMTP host

PROTONMAIL_PORT(num)
Default:587

SMTP port

PROTONMAIL_SECURE
Default:false

Use TLS for SMTP (true for port 465)

IMAP_HOST
Default:127.0.0.1

Proton Mail Bridge IMAP host (required for read/search tools)

IMAP_PORT(num)
Default:1143

Proton Mail Bridge IMAP port

IMAP_SECURE
Default:false

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
Default:false

Disable all mutating tools (send, move, delete, flags, labels, bulk ops, folder/label management)

RESTRICT_OUTBOUND_TO_SELF
Default:false

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
Default:false

Register the empty_folder tool (not recommended)

DEBUG
Default:false

Enable verbose logging to stderr