Verify the IMAP and SMTP credentials and report which actions are permitted.

Run this first when a tool fails or the account setup is unknown. Credentials are never included in the result.

List the folders in the mailbox, with their IMAP special-use flags.

Find messages, newest first, returning short summaries rather than full bodies.

Every filter is combined with AND, and omitting all of them returns the most recent messages in the folder. Reading a message costs a separate read_email call, using the uid from these results.

Open one message and return its body, headers, and attachment list.

Bodies are returned as plain text; HTML-only messages are converted, and long bodies are truncated with a marker rather than silently cut.

Block until mail arrives in the folder, then return the new messages.

Use this to wait for something expected, such as a verification code. It returns as soon as anything arrives, or empty-handed when the timeout elapses; nothing already in the folder is reported.

Save an attachment into the server's attachment directory and return its path.

Writes are confined to EMAIL_ATTACHMENT_DIR, and the sender's filename is sanitised before use.

Mark a message read or unread, and flag or unflag it.

Move a message to another folder. Requires EMAIL_ALLOW_DELETE=true.

Move a message to Trash. Requires EMAIL_ALLOW_DELETE=true.

This is a move, not an expunge, so the user can still recover the message from their Trash folder.

Send an email. This is irreversible: confirm the content with the user first.

Sending only works when EMAIL_ALLOW_SEND=true, and every recipient must pass the configured allowlist. Pass reply_to_uid to answer an existing message: the reply is threaded correctly and the recipient and subject are filled in from the original.

Write a message to the Drafts folder without sending it.

This is the safe way to prepare mail: the user opens their own mail client, reviews it, and sends it themselves. It works even when EMAIL_ALLOW_SEND is false, because nothing leaves the account.