Proton Workflow Connector MCP Server

by ntrpydevio.github.NtrpyDev/proton-workflow-connectorv1.3.0

Unofficial self-hosted MCP connector for Proton Mail Bridge and SimpleLogin.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Proton Workflow Connector MCP server

claude mcp add proton-workflow-connector -e PROTON_BRIDGE_USERNAME='<proton-bridge-username>' -e PROTON_BRIDGE_PASSWORD='<proton-bridge-password>' -e PROTON_BRIDGE_EMAIL='<proton-bridge-email>' -e SIMPLELOGIN_API_KEY='<simplelogin-api-key>' -- uvx proton-workflow-connector

{
  "mcpServers": {
    "proton-workflow-connector": {
      "command": "uvx",
      "args": [
        "proton-workflow-connector"
      ],
      "env": {
        "PROTON_BRIDGE_USERNAME": "<proton-bridge-username>",
        "PROTON_BRIDGE_PASSWORD": "<proton-bridge-password>",
        "PROTON_BRIDGE_EMAIL": "<proton-bridge-email>",
        "SIMPLELOGIN_API_KEY": "<simplelogin-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "proton-workflow-connector": {
      "command": "uvx",
      "args": [
        "proton-workflow-connector"
      ],
      "env": {
        "PROTON_BRIDGE_USERNAME": "<proton-bridge-username>",
        "PROTON_BRIDGE_PASSWORD": "<proton-bridge-password>",
        "PROTON_BRIDGE_EMAIL": "<proton-bridge-email>",
        "SIMPLELOGIN_API_KEY": "<simplelogin-api-key>"
      }
    }
  }
}

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

{
  "servers": {
    "proton-workflow-connector": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proton-workflow-connector"
      ],
      "env": {
        "PROTON_BRIDGE_USERNAME": "<proton-bridge-username>",
        "PROTON_BRIDGE_PASSWORD": "<proton-bridge-password>",
        "PROTON_BRIDGE_EMAIL": "<proton-bridge-email>",
        "SIMPLELOGIN_API_KEY": "<simplelogin-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "proton-workflow-connector": {
      "command": "uvx",
      "args": [
        "proton-workflow-connector"
      ],
      "env": {
        "PROTON_BRIDGE_USERNAME": "<proton-bridge-username>",
        "PROTON_BRIDGE_PASSWORD": "<proton-bridge-password>",
        "PROTON_BRIDGE_EMAIL": "<proton-bridge-email>",
        "SIMPLELOGIN_API_KEY": "<simplelogin-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
PROTON_BRIDGE_USERNAME	yes	—	Bridge IMAP/SMTP username (from the Bridge app)
PROTON_BRIDGE_PASSWORD	yes	yes	Bridge-generated password (never your Proton account password)
PROTON_BRIDGE_EMAIL	yes	—	Primary Proton address served by Bridge
SIMPLELOGIN_API_KEY	—	yes	SimpleLogin API key; omit to disable alias tools

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-14 · 3mo ago · GitHub
Latest release
2026-07-02 · 3mo ago · GitHub · v1.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-02 · 3mo ago · official registry · v1.3.0

FAQ

›How do I install the Proton Workflow Connector MCP server in Claude Code?

Run: claude mcp add proton-workflow-connector -e PROTON_BRIDGE_USERNAME='<proton-bridge-username>' -e PROTON_BRIDGE_PASSWORD='<proton-bridge-password>' -e PROTON_BRIDGE_EMAIL='<proton-bridge-email>' -e SIMPLELOGIN_API_KEY='<simplelogin-api-key>' -- uvx proton-workflow-connector. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Proton Workflow Connector require an API key?

Yes. It expects PROTON_BRIDGE_USERNAME, PROTON_BRIDGE_PASSWORD, PROTON_BRIDGE_EMAIL, SIMPLELOGIN_API_KEY, of which 2 are secrets.

›Can I use Proton Workflow Connector as a remote (hosted) MCP server?

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

›Is Proton Workflow Connector in the official MCP registry?

Yes, as io.github.NtrpyDev/proton-workflow-connector.