Proton Mail (unofficial) MCP Server

A Model Context Protocol (MCP) server that gives AI assistants full access to your Proton Mail account -- send, read, search, and organize email over SMTP and IMAP.

Local serverstdioMIT

What is the Proton Mail (unofficial) MCP Server?

Proton Mail MCP is an MCP project maintained in the sethbang/proton-mail-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that gives AI assistants full access to your Proton Mail account -- send, read, search, and organize email over…”. Read the project documentation for the complete scope.

Installation

The documented npm package is proton-mail-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares PROTONMAIL_USERNAME, PROTONMAIL_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
send_email
reply_email
reply_all_email
forward_email
save_draft
list_folders
list_messages
read_message
list_attachments
download_attachment
search_messages
get_thread
move_message
delete_message
update_message_flags
update_message_labels
mark_all_read
bulk_move
bulk_delete
bulk_update_flags
bulk_update_labels
create_folder
create_label
rename_folder
delete_folder
empty_folder
count_messages
folder_stats
top_senders
move_thread
delete_thread
flag_thread

How to install the Proton Mail (unofficial) MCP Server

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "env": {
        "PROTONMAIL_USERNAME": "your-email@protonmail.com",
        "PROTONMAIL_PASSWORD": "YOUR_PROTONMAIL_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PROTONMAIL_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
PROTONMAIL_PASSWORDDeclared in the maintainer’s client configuration.Check documentation