A community-driven registry for Claude, Cursor, Windsurf, Cline & more. Not affiliated with Anthropic.
Are you the author? Sign in to claim
ProtonMail MCP server — email management via Proton Bridge using the Model Context Protocol
Email management for AI agents through ProtonMail and Proton Bridge
Send, read, search, and organize emails from Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.
npx @ronamosa/protonmail-pro-mcp
Or install globally:
npm install -g @ronamosa/protonmail-pro-mcp
protonmail-pro-mcp
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.
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_PASSWORDis the bridge-generated password, not your ProtonMail login. Never commit.envfiles.
Add to ~/.claude.json under mcpServers, or run claude mcp add:
{
"mcpServers": {
"protonmail": {
"type": "stdio",
"command": "npx",
"args": ["@ronamosa/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": ["@ronamosa/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": ["@ronamosa/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.
| 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 |
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
readOnlyHint, destructiveHint, openWorldHint) per MCP specdelete_email moves to Trash first; permanent delete only from Trashnpm 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)
Originally scaffolded from anyrxo/protonmail-pro-mcp. Completely rewritten with modern MCP SDK, Zod validation, dual transport, and full tool implementations.
MIT
A Jetbrains IDE IntelliJ plugin aimed to provide coding agents the ability to leverage intelliJ's indexing of the codeba
Run Claude Code as an MCP server so any agent can delegate coding tasks to it
Browser automation using accessibility snapshots instead of screenshots