Proton Mail (unofficial) MCP Server

by sethbangio.github.sethbang/proton-mail-mcpv1.0.2

Unofficial Proton Mail integration via Proton Mail Bridge: send, read, search and organize email, with dry-run bulk operations and a read-only mode.

6Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained46d ago

Install Proton Mail (unofficial) MCP server

claude mcp add proton-mail -e PROTONMAIL_USERNAME='<protonmail-username>' -e PROTONMAIL_PASSWORD='<protonmail-password>' -e IMAP_PASSWORD='<imap-password>' -- npx -y proton-mail-mcp

{
  "mcpServers": {
    "proton-mail": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "<protonmail-username>",
        "PROTONMAIL_PASSWORD": "<protonmail-password>",
        "IMAP_PASSWORD": "<imap-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "proton-mail": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "<protonmail-username>",
        "PROTONMAIL_PASSWORD": "<protonmail-password>",
        "IMAP_PASSWORD": "<imap-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "proton-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "<protonmail-username>",
        "PROTONMAIL_PASSWORD": "<protonmail-password>",
        "IMAP_PASSWORD": "<imap-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "proton-mail": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "<protonmail-username>",
        "PROTONMAIL_PASSWORD": "<protonmail-password>",
        "IMAP_PASSWORD": "<imap-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PROTONMAIL_USERNAME	yes	—	Your Proton Mail email address
PROTONMAIL_PASSWORD	yes	yes	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	—	yes	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

Freshness

Maintained — last maintenance signal 46d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-24 · 46d ago · GitHub
Latest release
2026-05-30 · 4mo ago · GitHub · v1.0.2
Package published
no data · npm/PyPI
Registry entry updated
2026-05-30 · 4mo ago · official registry · v1.0.2

FAQ

›How do I install the Proton Mail (unofficial) MCP server in Claude Code?

Run: claude mcp add proton-mail -e PROTONMAIL_USERNAME='<protonmail-username>' -e PROTONMAIL_PASSWORD='<protonmail-password>' -e IMAP_PASSWORD='<imap-password>' -- npx -y proton-mail-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Proton Mail (unofficial) require an API key?

Yes. It expects PROTONMAIL_USERNAME, PROTONMAIL_PASSWORD, IMAP_PASSWORD, of which 2 are secrets.

›Can I use Proton Mail (unofficial) as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Proton Mail (unofficial) in the official MCP registry?

Yes, as io.github.sethbang/proton-mail-mcp.