protonmail-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PROTONMAIL_PASS | Yes | The Bridge-generated password for this account, copied from Proton Bridge's Mailbox details. | |
| PROTONMAIL_USER | Yes | The Proton Mail username (e.g., you@proton.me), copied from Proton Bridge's Mailbox details. | |
| PROTONMAIL_READONLY | No | Set to '1' to enable read-only mode, registering only the read tools and preventing any sends. | |
| PROTONMAIL_IMAP_PORT | No | The IMAP port shown in Proton Bridge's Mailbox details. Defaults to 1143 if not set. | |
| PROTONMAIL_SMTP_PORT | No | The SMTP port shown in Proton Bridge's Mailbox details. Defaults to 1025 if not set. | |
| PROTONMAIL_IMAP_SECURITY | No | The IMAP security mode: STARTTLS or SSL, as shown in Proton Bridge's Mailbox details. | |
| PROTONMAIL_SMTP_SECURITY | No | The SMTP security mode: STARTTLS or SSL, as shown in Proton Bridge's Mailbox details. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_mailA | Search email by any combination of free-text, sender, recipient, subject, and date range. With NO filters it returns your most recent inbox messages. Returns summaries (no body) newest first — use get_message with a result's uid to read the full text. |
| get_messageA | Read one full message by uid (from a search result). Quoted reply history and signatures are trimmed by default for readability; pass full=true to keep everything. The result lists any attachments (name/type/size) — use download_attachment to save one. |
| download_attachmentA | Save an attachment from a message to disk (into the configured download directory). Identify it by filename or 0-based index (from get_message); if the message has just one attachment, neither is needed. Returns the saved file path. |
| create_draftA | Compose a new email and save it to Drafts. Does NOT send — you review and send it yourself in Proton. Can include local file attachments. |
| send_messageA | Send a new email immediately. This goes out the moment it runs — the client should confirm first. To let a human review before sending, use create_draft instead. Can include local file attachments. |
| replyA | Reply to a message (to its sender), correctly threaded, quoting the original. Sends immediately unless draft=true (saves to Drafts for you to review). Can include local file attachments. |
| reply_allA | Reply to a message and everyone on it (sender + all other recipients, excluding you), threaded and quoting the original. Sends immediately unless draft=true. Can include local file attachments. |
| forwardA | Forward a message to new recipients, carrying its original attachments. Optional intro note via body. Sends immediately unless draft=true. Can add further local file attachments. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools are clearly distinct: search/get/download form a retrieval pipeline, and create_draft/send_message are explicitly contrasted. reply, reply_all, and forward could be confused, but their descriptions precisely define recipient behavior and threading.
Most tools follow a clear verb_noun pattern like search_mail, get_message, download_attachment, create_draft, send_message. However, reply and forward are bare verbs, and reply_all mixes a verb with an adverb, creating minor inconsistency.
Eight tools is a well-scoped set for an email-focused server. Each tool covers a distinct core email action without unnecessary redundancy or bloat.
The set covers search, read, download attachments, reply, reply-all, forward, draft, and send — the essential email workflows. Minor gaps like delete, move, or archive exist, but agents can handle common tasks end-to-end.