Skip to main content
Glama
ronamosa

ProtonMail MCP Server

by ronamosa
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

ProtonMail MCP Server

Email management for AI agents through ProtonMail and Proton Bridge

CI npm MCP SDK TypeScript License: MIT Node.js

Send, read, search, and organize emails from Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.

flowchart LR
  subgraph clients [" "]
    direction TB
    CC["Claude Code"]
    CD["Claude Desktop"]
    CU["Cursor"]
  end

  MCP["protonmail-pro-mcp<br/>16 tools · Zod validated"]

  subgraph mail [" "]
    direction TB
    SMTP["smtp.protonmail.ch"]
    Bridge["Proton Bridge"]
  end

  PM(("ProtonMail"))

  CC & CD & CU -->|stdio / HTTP| MCP
  MCP -->|"SMTP :587"| SMTP
  MCP -->|"IMAP :1143"| Bridge
  SMTP & Bridge --> PM

Quick start

Install from npm (recommended)

npx @sirency/protonmail-pro-mcp

Or install globally:

npm install -g @sirency/protonmail-pro-mcp
protonmail-pro-mcp

Install from source

git clone https://github.com/ronamosa/protonmail-pro-mcp.git
cd protonmail-pro-mcp
npm install
npm link

Verify the install:

which protonmail-pro-mcp

Prerequisites -- Node.js >= 18 and Proton Bridge running locally.

Configuration

cp .env.example .env   # then fill in your credentials

Variable

Required

Default

Description

PROTONMAIL_USERNAME

Yes

--

Your ProtonMail email address

PROTONMAIL_PASSWORD

Yes

--

Proton Bridge password (not your login password)

PROTONMAIL_SMTP_HOST

smtp.protonmail.ch

SMTP server host

PROTONMAIL_SMTP_PORT

587

SMTP server port

PROTONMAIL_IMAP_HOST

127.0.0.1

IMAP host (Proton Bridge)

PROTONMAIL_IMAP_PORT

1143

IMAP port (Proton Bridge)

PROTONMAIL_IMAP_TLS

false

Enable TLS for IMAP

PORT

3000

HTTP transport port

DEBUG

false

Enable debug logging

Security -- PROTONMAIL_PASSWORD is the bridge-generated password, not your ProtonMail login. Never commit .env files.

Usage

Add to ~/.claude.json under mcpServers, or run claude mcp add:

{
  "mcpServers": {
    "protonmail": {
      "type": "stdio",
      "command": "npx",
      "args": ["@sirency/protonmail-pro-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "you@protonmail.com",
        "PROTONMAIL_PASSWORD": "your-bridge-password"
      }
    }
  }
}

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["@sirency/protonmail-pro-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "you@protonmail.com",
        "PROTONMAIL_PASSWORD": "your-bridge-password"
      }
    }
  }
}

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["@sirency/protonmail-pro-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "you@protonmail.com",
        "PROTONMAIL_PASSWORD": "your-bridge-password"
      }
    }
  }
}
protonmail-pro-mcp --transport http --port 3000

Endpoints: POST /mcp, GET /mcp, DELETE /mcp (Streamable HTTP). Health check at GET /health.

Tools

Tool

Description

Send

send_email

Send with to/cc/bcc, HTML, priority, reply-to, attachments

send_test_email

Quick test email to verify SMTP

Read

get_emails

Fetch from a folder with pagination

get_email_by_id

Full email with body and headers

search_emails

Filter by from, to, subject, date, flags, attachments

Drafts

create_draft

Create a new draft in the Drafts folder

update_draft

Replace an existing draft with new content

delete_draft

Delete a draft

send_draft

Send a draft via SMTP and remove it from Drafts

Act

mark_email_read

Mark read or unread

star_email

Star or unstar

move_email

Move between folders

delete_email

Soft-delete to Trash; permanent only if already in Trash

Folders

get_folders

List all folders with message counts

sync_folders

Force-refresh folder list

System

get_connection_status

SMTP and IMAP connection health

Architecture

flowchart LR
  subgraph clients [MCP Clients]
    ClaudeCode[Claude Code]
    ClaudeDesktop[Claude Desktop]
    CursorIDE[Cursor]
  end

  subgraph transport [Transport Layer]
    STDIO[stdio]
    HTTP["Streamable HTTP<br/>:3000/mcp"]
  end

  subgraph server [protonmail-pro-mcp]
    McpServer["McpServer<br/>Zod validation"]

    subgraph toolGroups [Tools]
      direction TB
      Sending["send_email<br/>send_test_email"]
      Reading["get_emails<br/>get_email_by_id<br/>search_emails"]
      Drafts["create_draft / update_draft<br/>delete_draft / send_draft"]
      Actions["mark_read / star<br/>move / delete"]
      FolderTools["get_folders<br/>sync_folders"]
      SystemTools["connection_status"]
    end

    subgraph services [Services]
      SmtpSvc["SMTP Service<br/>nodemailer"]
      ImapSvc["IMAP Service<br/>imapflow"]
    end
  end

  subgraph infra [ProtonMail Infrastructure]
    SmtpServer["smtp.protonmail.ch<br/>:587 STARTTLS"]
    Bridge["Proton Bridge<br/>127.0.0.1:1143"]
    ProtonServers["ProtonMail<br/>Servers"]
  end

  ClaudeCode --> STDIO
  ClaudeDesktop --> STDIO
  CursorIDE --> STDIO
  ClaudeCode -.-> HTTP

  STDIO --> McpServer
  HTTP --> McpServer

  McpServer --> Sending
  McpServer --> Reading
  McpServer --> Drafts
  McpServer --> Actions
  McpServer --> FolderTools
  McpServer --> SystemTools

  Sending --> SmtpSvc
  Drafts --> SmtpSvc
  Drafts --> ImapSvc
  SystemTools --> SmtpSvc
  Reading --> ImapSvc
  Actions --> ImapSvc
  FolderTools --> ImapSvc
  SystemTools --> ImapSvc

  SmtpSvc -->|"SMTP / TLS"| SmtpServer
  ImapSvc -->|"IMAP"| Bridge
  SmtpServer --> ProtonServers
  Bridge -->|"encrypted tunnel"| ProtonServers
src/
  index.ts            Entry point, transport selection, graceful shutdown
  server.ts           McpServer setup, tool registration
  config.ts           Zod-validated environment configuration
  logger.ts           Structured stderr logger with credential redaction
  types.ts            Shared TypeScript interfaces
  services/
    smtp.ts           nodemailer wrapper (lazy connection)
    imap.ts           imapflow + mailparser wrapper (lazy connection, auto-reconnect)
  tools/
    sending.ts        send_email, send_test_email
    reading.ts        get_emails, get_email_by_id, search_emails
    drafts.ts         create_draft, update_draft, delete_draft, send_draft
    actions.ts        mark_email_read, star_email, move_email, delete_email
    folders.ts        get_folders, sync_folders
    system.ts         get_connection_status

  • McpServer API (SDK v1.29+) with Zod input validation on every tool

  • Tool annotations (readOnlyHint, destructiveHint, openWorldHint) per MCP spec

  • Dual transport -- stdio for local use, Streamable HTTP for remote deployment

  • Lazy connections -- SMTP and IMAP connect on first use, not at startup

  • Credential redaction -- passwords scrubbed from all log output

  • Soft delete -- delete_email moves to Trash first; permanent delete only from Trash

Development

npm run dev          # Watch mode with tsx
npm run typecheck    # Type checking without emit
npm run lint         # ESLint
npm run format       # Prettier
npm test             # Run tests
npm run build        # Rebuild (symlink picks up changes automatically)

Credits

Originally scaffolded from anyrxo/protonmail-pro-mcp. Completely rewritten with modern MCP SDK, Zod validation, dual transport, and full tool implementations.

License

MIT

Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ronamosa/protonmail-pro-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server