Mailoo

⚠️ DESTRUCTIVE: Permanently delete a mailbox and ALL its contents. This cannot be undone. Use list_mailboxes to verify the folder path.

Description is built at runtime.

Description is built at runtime.

Extract calendar events (ICS/iCalendar) from an email. Returns structured event data including time, location, attendees, and status.

Extract unique contacts from recent email headers. Returns contacts sorted by frequency (most frequent first). Useful for finding frequent correspondents or building an address book.

Find which real mailbox folder(s) an email belongs to. Required before move_email or delete_email when the email was found in a virtual folder (e.g., "All Mail", "Starred"). Returns the real folder path to use as sourceMailbox.

Forward an email to new recipients with optional additional message. Original email is quoted below. Original attachments are not included.

Get the full content of a specific email by ID. Does NOT mark the email as seen (uses IMAP BODY.PEEK — non-destructive). Use format="text" to strip HTML, or format="stripped" to also remove quoted replies and signatures. Use maxLength to cap the body size for large emails. Set markRead=true only when you want to explicitly mark the email as read.

Read-only SPF/DKIM/DMARC and From/Reply-To/Return-Path domain signals for an email. Does not change flags. Does not return unsubscribe or tracking URLs.

Get email statistics and analytics for a mailbox. Shows volume, top senders, daily trends, and read/flagged counts.

Get the current read/flag/label state of an email without fetching its body. Much cheaper than get_email when you only need to check whether an email is unread, flagged, or which labels it has. Also useful to confirm the result of a mark_email call. Does NOT mark the email as seen.

Fetch the full content of multiple emails in a single call (max 20). More efficient than calling get_email repeatedly when triaging or summarising several emails. Does NOT mark emails as seen. Defaults to format="text" (HTML stripped) for compact, AI-friendly output.

Get the current AI hooks configuration including preset, rules, and custom instructions.

Reconstruct a full email conversation thread by following References and In-Reply-To headers. Returns all related messages. Does NOT mark emails as seen. Use format="text" to strip HTML, or format="stripped" to also remove quoted replies. Use newestFirst=true to show the most recent message in full and older messages as header-only summaries. Use get_email first to obtain the message_id.

Get the status of IMAP IDLE watcher connections and recent activity.

List all configured email accounts. Call this first to discover available account names for use with other tools.

List all available local calendars (macOS Calendar.app / Linux default). Use the returned calendar names with add_to_calendar to target a specific calendar.

List emails in a mailbox with optional filters. Returns paginated results with metadata (read/unread 🔵, flagged ⭐, replied ↩️, attachments 📎, labels 🏷️). Use get_email to fetch full body content. ProtonMail note: labels are represented as IMAP folders — use list_labels to discover them, then list_emails with mailbox="Labels/X" to find labeled emails.

List local calendar events with optional filters. Search by title, date range, or calendar name. Use to check for existing events before creating new ones, or to verify a recently added event. Returns event id, title, start/end time, location, and calendar name.

List available labels for an email account. Auto-detects the label system: ProtonMail folder-labels, Gmail X-GM-LABELS, or IMAP keywords. ProtonMail note: labels are represented as IMAP folders under the Labels/ prefix. Use list_emails with mailbox="Labels/<name>" to find emails tagged with a ProtonMail label.

List all mailbox folders for an account with unread counts and special-use flags. Use list_accounts first to get the account name.

List all available AI triage presets with their descriptions and suggested labels.

List reminders from macOS Reminders.app with optional filters. Search by title or list name. By default only shows incomplete reminders. Use to check for existing reminders before creating new ones, or to verify a recently added reminder. Returns reminder id, title, due date, completion status, priority, and list name.

List scheduled emails. Shows pending, sent, or all scheduled emails.

Description is built at runtime.

Change email flags — mark as read/unread, flag/unflag. Idempotent: marking an already-read email as read is a no-op.

Move an email to a different mailbox folder. The sourceMailbox must be a real folder, not a virtual one like "All Mail". Use find_email_folder first if the email was discovered in a virtual folder.

Remove a label from an email. For ProtonMail, this removes the email from the label folder. For Gmail and standard IMAP, this removes a keyword flag.

Rename an existing mailbox (folder). Use list_mailboxes to see current folder paths.

Reply to an email with proper threading (In-Reply-To & References headers). Use get_email first to read the original.

Save an email draft to the Drafts folder. Compose over time, then use send_draft to send it. Use list_emails with the Drafts mailbox to see saved drafts.

Schedule an email to be sent at a specific time in the future. The email is queued locally and sent automatically when the time arrives.

Search emails by keyword across subject, sender, and body. Omit query (or pass an empty string) to use it as a pure filter — e.g. find all emails with attachments from a specific recipient without a keyword. Supports additional filters for recipient, attachments, size, and reply status.

Send an existing draft email and remove it from Drafts. The draft is fetched, sent via SMTP, then deleted. Use list_emails with the Drafts mailbox to find draft IDs.

Send a new email. Supports plain text or HTML body, CC, BCC, and attachments. Optional messageId lets a retried call reuse the same Message-ID.

Activate a ManageSieve script (RFC 5804 SETACTIVE). Pass an empty name to deactivate all.

Delete a ManageSieve script (RFC 5804 DELETESCRIPT). Active scripts must be deactivated first.

Download a ManageSieve script by name (RFC 5804 GETSCRIPT).

List ManageSieve scripts on the account (RFC 5804 LISTSCRIPTS).

Create or replace a ManageSieve script (RFC 5804 PUTSCRIPT). Does not activate it.

Detect whether ManageSieve is available for an account (port 4190 by default). If the provider only exposes filters in a web UI, this reports a warning rather than IMAP capabilities.

Send a test desktop notification to verify that OS permissions are correctly configured. Use check_notification_setup first to diagnose any issues.