Lists every IMAP mailbox exposed by Proton Bridge (system folders like INBOX/Sent/Trash and user labels/folders). Use the returned 'path' values as the mailbox argument in other tools. Call this first when the agent doesn't know the mailbox layout.

Creates a new IMAP mailbox under the given path (e.g. 'Projects/Afiladocs').

Returns total messages, unseen/unread count and recent count for a mailbox. Fast — useful for Routines to check 'do I have unread mail?'.

Lists recent emails in a mailbox, newest first. Use pagination with offset+limit. Returns UID, from, to, subject, date, flags, size. Does NOT return the body — use proton_get_email for that.

Keyword-search emails in a mailbox. Filter by text in any field, or restrict to subject/from/to/body. Combine with date range and unseen flag. Returns newest matches first, up to 'limit'. Use 'text' for a broad 'anywhere' match.

Fetches one email by UID, with headers, text/html body and attachment metadata. Use proton_get_attachment to download attachment bytes. Large HTML bodies are returned as-is — truncate client-side if needed. To mark as read, call proton_flag_email separately (keeps this tool purely read-only).

Returns the bytes of a specific attachment encoded as base64. Use the attachment index from proton_get_email. Large attachments are truncated to max_bytes (default 10 MB) with a truncated=true flag in the response.

Sends an email via Proton Bridge SMTP. 'from' is fixed to the configured address. Provide either text, html, or both. Attachments are base64-encoded bytes.

Replies to an existing message preserving threading (In-Reply-To, References). Set reply_all=true to include CC recipients. Set include_quote=true to quote the original.

Forwards an existing message to new recipients. Optionally includes original attachments.

Toggles per-message flags. Supported: 'read', 'unread', 'starred', 'unstarred'. For custom flags, pass add_flags/remove_flags directly.

Moves a message by UID from one mailbox to another. Use proton_list_folders to see valid targets.

Deletes a message. Default mode='trash' moves it to Trash (reversible). mode='permanent' expunges immediately — cannot be undone.

Analyzes the mailbox using the embedded agent rules and returns a proposed folder/label structure plus content alerts. This is a read-only planning tool; it does not move, flag or delete emails. Use it before running the CLI agent:organize command.

Scans the staging directory and returns an inventory report: total files, by type/size/date, duplicates, and obsolete formats.

Returns the current state of the proton-drive CLI binary and the local staging directory.

Analyzes the staging directory and moves files into a structured folder layout (by type). Dry-run by default.

Detailed analysis of file formats in the staging directory.

Lists the contents of a remote Proton Drive path using the proton-drive CLI. Read-only.

Downloads a remote Proton Drive path into the local staging directory using the proton-drive CLI. Idempotent.

Uploads the local staging directory to a remote Proton Drive path using the proton-drive CLI.

Invites a Proton user to collaborate on a remote path using the proton-drive CLI.

Moves a remote path using the proton-drive CLI.

Copies a remote path using the proton-drive CLI.

Creates a new folder using the proton-drive CLI.

Permanently removes a remote path from Proton Drive. Destructive operation.

Checks whether the proton-drive CLI is installed and authenticated. Use this before any Drive operation that requires auth.

Attempts to authenticate with the proton-drive CLI. Since the CLI requires interactive credentials (username, password, 2FA), the tool returns a command the user must run in their terminal. Check auth status with proton_drive_auth_status after running the command.

Reports the connection status, diagnostics, and metrics of all configured Proton Suite products.

Which Proton product binaries are installed and their auth status.

Unified health status of all Proton ecosystem binaries. Returns a concise pass/fail summary.

Available version updates for Proton binaries.

Instructions for installing a Proton product binary.

Checks if Proton Mail Bridge is running, ports are listening, and IMAP auth works.

Returns combined info + health of the Bridge process in a single call.

Returns Bridge version, user, and connection ports from the CLI.

Performs interactive login against Proton Mail Bridge. Provide user and password; include TOTP if 2FA is required.

Logs out the current session from Proton Mail Bridge.

Lists all Proton accounts currently configured in Bridge with their connection state.