Package Exports

protonmail-mcp-server
protonmail-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (protonmail-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ProtonMail MCP Server

Model Context Protocol server for ProtonMail with 23 tools for email management through Proton Bridge.

Features

Email sending - Send emails with HTML/text, attachments, CC/BCC, custom headers
Email reading - Fetch, search, and filter emails via IMAP
Folder management - Create, delete, rename, list, and sync folders
Email operations - Mark read/unread, star, move, delete
Analytics - Email volume trends, contact statistics, response time analysis
System tools - Connection status, cache management, logging

Quick Start

Prerequisites

ProtonMail account
Proton Bridge installed and running
Node.js 18.0.0+

Installation

From npm:

npm install -g protonmail-mcp-server

From source:

git clone https://github.com/barhatch/protonmail-mcp-server.git
cd protonmail-mcp-server
npm install && npm run build

Configuration

Edit Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "protonmail-mcp-server"],
      "env": {
        "PROTONMAIL_USERNAME": "your-email@protonmail.com",
        "PROTONMAIL_PASSWORD": "your-bridge-password",
        "PROTONMAIL_SMTP_HOST": "127.0.0.1",
        "PROTONMAIL_SMTP_PORT": "1025",
        "PROTONMAIL_IMAP_HOST": "127.0.0.1",
        "PROTONMAIL_IMAP_PORT": "1143"
      }
    }
  }
}

Notes:

Use 127.0.0.1 not localhost to avoid IPv6 issues
Password is your Proton Bridge password, not your ProtonMail login
Get Bridge password from Proton Bridge → Settings → Mailbox Password

Available Tools

Email Sending

send_email - Send email with HTML/text, attachments, CC/BCC
send_test_email - Send test email

Email Reading

get_emails - Fetch emails with pagination/filtering
get_email_by_id - Get specific email
search_emails - Search with multiple criteria

Folder Management

get_folders - List folders with stats
sync_folders - Sync folder structure
create_folder - Create new folder
delete_folder - Delete folder (must be empty)
rename_folder - Rename folder

Email Actions

mark_email_read - Mark read/unread
star_email - Star/unstar
move_email - Move between folders
delete_email - Delete permanently

Analytics

get_email_stats - Email statistics
get_email_analytics - Analytics and insights
get_contacts - Contact interaction stats
get_volume_trends - Email volume over time

System

get_connection_status - Check SMTP/IMAP status
sync_emails - Manual sync
clear_cache - Clear cache
get_logs - Get logs

Troubleshooting

Connection refused ::1:1143

Use 127.0.0.1 instead of localhost
Verify Proton Bridge is running: lsof -i :1025 -i :1143

Authentication failed

Use Proton Bridge password (not ProtonMail login)
Get from Proton Bridge → Settings → Mailbox Password

Certificate errors

Self-signed certs are automatically accepted for localhost

Development

npm run dev      # Watch mode
npm run build    # Build
npm run lint     # Type check

License

MIT - See LICENSE

Links

Unofficial third-party server, not affiliated with Proton AG.