ProtonMail MCP Server

An MCP (Model Context Protocol) server that connects to ProtonMail via Bridge, enabling AI assistants like Claude to manage your email.

Features

• Email Management: Read, search, send, reply, forward, and delete emails

• Folder Management: List, create, rename, and delete folders

• Label Management: Apply and remove labels from emails

• Trend Analysis: Analyze email patterns, identify important emails, track sender statistics

Related MCP server: protonmail-mcp-server

Requirements

• Node.js >= 18

• ProtonMail Bridge installed and running

• ProtonMail account (Plus, Unlimited, or Business)

Installation

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

Configuration

1. Copy the example config:

   cp config/protonmail.config.example.json config/protonmail.config.json

2. Edit config/protonmail.config.json with your credentials:

   {
     "protonmail": {
       "auth": {
         "user": "your-email@protonmail.com",
         "pass": "your-bridge-password"
       }
     }
   }

   Note: Use the Bridge password from ProtonMail Bridge app (not your account password).

Running the Server

npm start

The server listens on port 3000 by default. Set the PORT environment variable to change it:

PORT=8080 npm start

MCP endpoint: http://localhost:3000/mcp

Usage with Claude Desktop

The server uses the MCP Streamable HTTP transport (spec 2025-03-26), so configure Claude Desktop with a URL instead of a command:

{
  "mcpServers": {
    "protonmail": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Note: Start the server before launching Claude Desktop (npm start).

Legacy stdio (not supported)

This server no longer supports stdio transport. If you need stdio, use an earlier version.

Available Tools (22)

Email Reading

Email Sending

Folder Management

Label Management

Analytics

Utility

Resources

Development

# Build
npm run build

# Watch mode
npm run dev

# Run directly with tsx
npx tsx src/server.ts

License

MIT