Skip to content
MCP server

Proton Mail (unofficial)

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

Runs locallyStatus and history
Install
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-mcp

Add 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 addressRequired
  • PROTONMAIL_PASSWORDYour Proton Mail SMTP password (not your login password; generate one in Proton settings)Required
  • PROTONMAIL_HOSTSMTP host
  • PROTONMAIL_PORTSMTP port
  • PROTONMAIL_SECUREUse TLS for SMTP (true for port 465)
  • IMAP_HOSTProton Mail Bridge IMAP host (required for read/search tools)
  • IMAP_PORTProton Mail Bridge IMAP port
  • IMAP_SECUREUse TLS for IMAP
  • IMAP_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 base64
  • ALLOW_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.

How AIPoweredBot checks servers