Skip to content
MCP server

Proton Mail MCP

Proton Mail MCP via Bridge (IMAP/SMTP) · 13 tools · dual transport stdio + HTTP.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
6 days ago

About Proton Mail MCP

Proton Mail MCP 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 PROTON_USERNAME='<PROTON_USERNAME>' --env PROTON_PASSWORD='<PROTON_PASSWORD>' -- npx -y @alexendros/proton-mail-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_USERNAME": "<PROTON_USERNAME>",
        "PROTON_PASSWORD": "<PROTON_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_USERNAME": "<PROTON_USERNAME>",
        "PROTON_PASSWORD": "<PROTON_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "proton-mail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_USERNAME": "<PROTON_USERNAME>",
        "PROTON_PASSWORD": "<PROTON_PASSWORD>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_USERNAME": "<PROTON_USERNAME>",
        "PROTON_PASSWORD": "<PROTON_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_USERNAME": "<PROTON_USERNAME>",
        "PROTON_PASSWORD": "<PROTON_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PROTON_BRIDGE_HOSTHostname or IP of the Proton Mail Bridge (default: 127.0.0.1 for local, or container hostname in compose).
  • PROTON_IMAP_PORTIMAP port exposed by Proton Mail Bridge (default: 1143).
  • PROTON_SMTP_PORTSMTP port exposed by Proton Mail Bridge (default: 1025).
  • PROTON_USERNAMEBridge username (your Proton Mail address).Required
  • PROTON_PASSWORDBridge-generated app password (NOT your Proton account password).Required

Pricing

Open source

Proton Mail MCP FAQ

Is Proton Mail MCP free?

Yes. Proton Mail MCP is open source, so you can use and self-host it for free.

How do I add Proton Mail MCP to Claude Code?

Run this command in your terminal: claude mcp add proton-mail-mcp --env PROTON_USERNAME='<PROTON_USERNAME>' --env PROTON_PASSWORD='<PROTON_PASSWORD>' -- npx -y @alexendros/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