Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "${PROTONMAIL_USERNAME}",
        "PROTONMAIL_PASSWORD": "${PROTONMAIL_PASSWORD}",
        "PROTONMAIL_HOST": "smtp.protonmail.ch",
        "PROTONMAIL_PORT": "587",
        "PROTONMAIL_SECURE": "false",
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_PASSWORD": "${IMAP_PASSWORD}",
        "READONLY": "false",
        "RESTRICT_OUTBOUND_TO_SELF": "false",
        "ALLOW_EMPTY_FOLDER": "false",
        "DEBUG": "false"
      }
    }
  }
}

claude mcp add proton-mail-mcp -e "PROTONMAIL_USERNAME=${PROTONMAIL_USERNAME}" -e "PROTONMAIL_PASSWORD=${PROTONMAIL_PASSWORD}" -e "PROTONMAIL_HOST=smtp.protonmail.ch" -e "PROTONMAIL_PORT=587" -e "PROTONMAIL_SECURE=false" -e "IMAP_HOST=127.0.0.1" -e "IMAP_PORT=1143" -e "IMAP_SECURE=false" -e "IMAP_PASSWORD=${IMAP_PASSWORD}" -e "READONLY=false" -e "RESTRICT_OUTBOUND_TO_SELF=false" -e "ALLOW_EMPTY_FOLDER=false" -e "DEBUG=false" -- npx -y [email protected]

[mcp_servers.proton-mail-mcp]
command = "npx"
args = ["-y", "[email protected]"]
env = { "PROTONMAIL_USERNAME" = "${PROTONMAIL_USERNAME}", "PROTONMAIL_PASSWORD" = "${PROTONMAIL_PASSWORD}", "PROTONMAIL_HOST" = "smtp.protonmail.ch", "PROTONMAIL_PORT" = "587", "PROTONMAIL_SECURE" = "false", "IMAP_HOST" = "127.0.0.1", "IMAP_PORT" = "1143", "IMAP_SECURE" = "false", "IMAP_PASSWORD" = "${IMAP_PASSWORD}", "READONLY" = "false", "RESTRICT_OUTBOUND_TO_SELF" = "false", "ALLOW_EMPTY_FOLDER" = "false", "DEBUG" = "false" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "proton-mail-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "[email protected]"
      ],
      "enabled": true,
      "environment": {
        "PROTONMAIL_USERNAME": "{env:PROTONMAIL_USERNAME}",
        "PROTONMAIL_PASSWORD": "{env:PROTONMAIL_PASSWORD}",
        "PROTONMAIL_HOST": "smtp.protonmail.ch",
        "PROTONMAIL_PORT": "587",
        "PROTONMAIL_SECURE": "false",
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_PASSWORD": "{env:IMAP_PASSWORD}",
        "READONLY": "false",
        "RESTRICT_OUTBOUND_TO_SELF": "false",
        "ALLOW_EMPTY_FOLDER": "false",
        "DEBUG": "false"
      }
    }
  }
}

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "${PROTONMAIL_USERNAME}",
        "PROTONMAIL_PASSWORD": "${PROTONMAIL_PASSWORD}",
        "PROTONMAIL_HOST": "smtp.protonmail.ch",
        "PROTONMAIL_PORT": "587",
        "PROTONMAIL_SECURE": "false",
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_PASSWORD": "${IMAP_PASSWORD}",
        "READONLY": "false",
        "RESTRICT_OUTBOUND_TO_SELF": "false",
        "ALLOW_EMPTY_FOLDER": "false",
        "DEBUG": "false"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=proton-mail-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInByb3Rvbi1tYWlsLW1jcEAxLjAuMiJdLCJlbnYiOnsiUFJPVE9OTUFJTF9VU0VSTkFNRSI6IiR7UFJPVE9OTUFJTF9VU0VSTkFNRX0iLCJQUk9UT05NQUlMX1BBU1NXT1JEIjoiJHtQUk9UT05NQUlMX1BBU1NXT1JEfSIsIlBST1RPTk1BSUxfSE9TVCI6InNtdHAucHJvdG9ubWFpbC5jaCIsIlBST1RPTk1BSUxfUE9SVCI6IjU4NyIsIlBST1RPTk1BSUxfU0VDVVJFIjoiZmFsc2UiLCJJTUFQX0hPU1QiOiIxMjcuMC4wLjEiLCJJTUFQX1BPUlQiOiIxMTQzIiwiSU1BUF9TRUNVUkUiOiJmYWxzZSIsIklNQVBfUEFTU1dPUkQiOiIke0lNQVBfUEFTU1dPUkR9IiwiUkVBRE9OTFkiOiJmYWxzZSIsIlJFU1RSSUNUX09VVEJPVU5EX1RPX1NFTEYiOiJmYWxzZSIsIkFMTE9XX0VNUFRZX0ZPTERFUiI6ImZhbHNlIiwiREVCVUciOiJmYWxzZSJ9fQ%3D%3D"
}

{
  "servers": {
    "proton-mail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "${PROTONMAIL_USERNAME}",
        "PROTONMAIL_PASSWORD": "${PROTONMAIL_PASSWORD}",
        "PROTONMAIL_HOST": "smtp.protonmail.ch",
        "PROTONMAIL_PORT": "587",
        "PROTONMAIL_SECURE": "false",
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_PASSWORD": "${IMAP_PASSWORD}",
        "READONLY": "false",
        "RESTRICT_OUTBOUND_TO_SELF": "false",
        "ALLOW_EMPTY_FOLDER": "false",
        "DEBUG": "false"
      }
    }
  }
}

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "${PROTONMAIL_USERNAME}",
        "PROTONMAIL_PASSWORD": "${PROTONMAIL_PASSWORD}",
        "PROTONMAIL_HOST": "smtp.protonmail.ch",
        "PROTONMAIL_PORT": "587",
        "PROTONMAIL_SECURE": "false",
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_PASSWORD": "${IMAP_PASSWORD}",
        "READONLY": "false",
        "RESTRICT_OUTBOUND_TO_SELF": "false",
        "ALLOW_EMPTY_FOLDER": "false",
        "DEBUG": "false"
      }
    }
  }
}

extensions:
  "proton-mail-mcp":
    enabled: true
    name: "proton-mail-mcp"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "[email protected]"
    envs:
      "PROTONMAIL_USERNAME": "${PROTONMAIL_USERNAME}"
      "PROTONMAIL_PASSWORD": "${PROTONMAIL_PASSWORD}"
      "PROTONMAIL_HOST": "smtp.protonmail.ch"
      "PROTONMAIL_PORT": "587"
      "PROTONMAIL_SECURE": "false"
      "IMAP_HOST": "127.0.0.1"
      "IMAP_PORT": "1143"
      "IMAP_SECURE": "false"
      "IMAP_PASSWORD": "${IMAP_PASSWORD}"
      "READONLY": "false"
      "RESTRICT_OUTBOUND_TO_SELF": "false"
      "ALLOW_EMPTY_FOLDER": "false"
      "DEBUG": "false"
    timeout: 300

Placeholders to fill from your own secret store: ${PROTONMAIL_PASSWORD}, ${IMAP_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies33 · weight 15

fail
deps.known_vulns4 advisories to act on (malicious, or rated high or critical with a fix available): GHSA-2x7j-588g-ccc2 in [email protected] (direct, fixed in 9.1.0), GHSA-p6gq-j5cr-w38f in [email protected] (direct, fixed in 9.0.1), GHSA-v53p-9fqp-m79j in [email protected] (direct, fixed in 10.0.6), ...; 5 more of lower severity or without a fix
fail
deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
pass
deps.resolvable[email protected] resolved: 154 packages

Tool list unknown · checked 2026-10-20 11:40 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance90

livenessn/a

freshness65

hygiene100

+repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-143d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm153 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19

advisory	severity	package	fixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.31.0`
GHSA-2x7j-588g-ccc2Nodemailer: Quadratic (O(n²)) time complexity in addressparser allows remote denial of service via a crafted address list	high	`[email protected]`direct	fixed in `9.1.0`
GHSA-p6gq-j5cr-w38fNodemailer: Message-level raw option bypasses disableFileAccess/disableUrlAccess, enabling arbitrary file read and full-response SSRF in the delivered message	high	`[email protected]`direct	fixed in `9.0.1`
GHSA-v53p-9fqp-m79jNodemailer: Quadratic backtracking in the addressparser free-text fallback allows remote denial of service	high	`[email protected]`direct	fixed in `10.0.6`
GHSA-68fv-2mgg-jv7qsource-map-js allows event-loop denial of service through indexed source-map section offsets	high	`[email protected]`indirect	fixed in `1.2.2`
GHSA-6vj9-mwq6-2f5vNodemailer: Process-global DNS cache reuses TLS `servername` across transports, enabling cross-tenant SMTP credential disclosure	moderate	`[email protected]`direct	fixed in `10.0.2`
GHSA-8m3c-c648-2xjjNodemailer: resolveContent() on a MailMessage bypasses disableFileAccess/disableUrlAccess when called with the legacy signature	moderate	`[email protected]`direct	fixed in `9.1.1`
GHSA-8vvx-rff5-p5rqNodemailer: Nested structured recipient arrays bypass the parser depth limit and cause stack exhaustion DoS	moderate	`[email protected]`direct	fixed in `10.0.2`
GHSA-cc9r-2j5m-2m83Nodemailer: Recipient-domain validation bypass via RFC 5322 comment mis-parsing leads to email delivery to an attacker-controlled domain	moderate	`[email protected]`direct	fixed in `9.1.0`
GHSA-wmmp-3585-3rmpNodemailer: IDN/Punycode domain allow-list bypass leads to email delivery to an attacker-controlled domain	moderate	`[email protected]`direct	fixed in `9.1.0`

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`proton-mail-mcp`	npm	1.0.2	npx	`PROTONMAIL_PASSWORD`, `IMAP_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

More from io.github.sethbang

Official server.json

{
  "name": "io.github.sethbang/proton-mail-mcp",
  "title": "Proton Mail (unofficial)",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.0.2",
  "packages": [
    {
      "version": "1.0.2",
      "transport": {
        "type": "stdio"
      },
      "identifier": "proton-mail-mcp",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "PROTONMAIL_USERNAME",
          "isRequired": true,
          "description": "Your Proton Mail email address"
        },
        {
          "name": "PROTONMAIL_PASSWORD",
          "isSecret": true,
          "isRequired": true,
          "description": "Your Proton Mail SMTP password (not your login password; generate one in Proton settings)"
        },
        {
          "name": "PROTONMAIL_HOST",
          "default": "smtp.protonmail.ch",
          "description": "SMTP host"
        },
        {
          "name": "PROTONMAIL_PORT",
          "format": "number",
          "default": "587",
          "description": "SMTP port"
        },
        {
          "name": "PROTONMAIL_SECURE",
          "default": "false",
          "description": "Use TLS for SMTP (true for port 465)"
        },
        {
          "name": "IMAP_HOST",
          "default": "127.0.0.1",
          "description": "Proton Mail Bridge IMAP host (required for read/search tools)"
        },
        {
          "name": "IMAP_PORT",
          "format": "number",
          "default": "1143",
          "description": "Proton Mail Bridge IMAP port"
        },
        {
          "name": "IMAP_SECURE",
          "default": "false",
          "description": "Use TLS for IMAP"
        },
        {
          "name": "IMAP_USERNAME",
          "description": "Proton Mail Bridge username (falls back to PROTONMAIL_USERNAME)"
        },
        {
          "name": "IMAP_PASSWORD",
          "isSecret": true,
          "description": "Proton Mail Bridge password (falls back to PROTONMAIL_PASSWORD)"
        },
        {
          "name": "READONLY",
          "default": "false",
          "description": "Disable all mutating tools (send, move, delete, flags, labels, bulk ops, folder/label management)"
        },
        {
          "name": "RESTRICT_OUTBOUND_TO_SELF",
          "default": "false",
          "description": "Refuse live sends to any recipient other than PROTONMAIL_USERNAME (for throwaway/QA accounts)"
        },
        {
          "name": "ALLOW_FILE_DOWNLOAD_DIR",
          "description": "Allowlist directory enabling download_attachment.saveTo; when unset, attachments return as inline base64"
        },
        {
          "name": "ALLOW_EMPTY_FOLDER",
          "default": "false",
          "description": "Register the empty_folder tool (not recommended)"
        },
        {
          "name": "DEBUG",
          "default": "false",
          "description": "Enable verbose logging to stderr"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/sethbang/proton-mail-mcp",
    "source": "github"
  },
  "websiteUrl": "https://sethbang.github.io/proton-mail-mcp/",
  "description": "Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP"
}