Proton Mail (unofficial)
Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- 5 days ago
About Proton Mail (unofficial)
Proton Mail (unofficial) is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add proton-mail-mcp --env PROTONMAIL_USERNAME='<PROTONMAIL_USERNAME>' --env PROTONMAIL_PASSWORD='<PROTONMAIL_PASSWORD>' --env IMAP_PASSWORD='<IMAP_PASSWORD>' -- npx -y proton-mail-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"proton-mail-mcp": {
"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
{
"mcpServers": {
"proton-mail-mcp": {
"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
{
"servers": {
"proton-mail-mcp": {
"type": "stdio",
"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
{
"mcpServers": {
"proton-mail-mcp": {
"command": "npx",
"args": [
"-y",
"proton-mail-mcp"
],
"env": {
"PROTONMAIL_USERNAME": "<PROTONMAIL_USERNAME>",
"PROTONMAIL_PASSWORD": "<PROTONMAIL_PASSWORD>",
"IMAP_PASSWORD": "<IMAP_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proton-mail-mcp": {
"command": "npx",
"args": [
"-y",
"proton-mail-mcp"
],
"env": {
"PROTONMAIL_USERNAME": "<PROTONMAIL_USERNAME>",
"PROTONMAIL_PASSWORD": "<PROTONMAIL_PASSWORD>",
"IMAP_PASSWORD": "<IMAP_PASSWORD>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PROTONMAIL_USERNAMEYour Proton Mail email addressRequiredPROTONMAIL_PASSWORDYour Proton Mail SMTP password (not your login password; generate one in Proton settings)RequiredPROTONMAIL_HOSTSMTP hostPROTONMAIL_PORTSMTP portPROTONMAIL_SECUREUse TLS for SMTP (true for port 465)IMAP_HOSTProton Mail Bridge IMAP host (required for read/search tools)IMAP_PORTProton Mail Bridge IMAP portIMAP_SECUREUse TLS for IMAPIMAP_USERNAMEProton Mail Bridge username (falls back to PROTONMAIL_USERNAME)IMAP_PASSWORDProton Mail Bridge password (falls back to PROTONMAIL_PASSWORD)READONLYDisable all mutating tools (send, move, delete, flags, labels, bulk ops, folder/label management)RESTRICT_OUTBOUND_TO_SELFRefuse live sends to any recipient other than PROTONMAIL_USERNAME (for throwaway/QA accounts)ALLOW_FILE_DOWNLOAD_DIRAllowlist directory enabling download_attachment.saveTo; when unset, attachments return as inline base64ALLOW_EMPTY_FOLDERRegister the empty_folder tool (not recommended)DEBUGEnable verbose logging to stderr
Pricing
Open source
Prices change. Check sethbang.github.io before you buy.
Proton Mail (unofficial) FAQ
Is Proton Mail (unofficial) free?
Yes. Proton Mail (unofficial) is open source, so you can use and self-host it for free.
How do I add Proton Mail (unofficial) to Claude Code?
Run this command in your terminal: claude mcp add proton-mail-mcp --env PROTONMAIL_USERNAME='<PROTONMAIL_USERNAME>' --env PROTONMAIL_PASSWORD='<PROTONMAIL_PASSWORD>' --env IMAP_PASSWORD='<IMAP_PASSWORD>' -- npx -y proton-mail-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.