List emails in a folder. Returns envelope data: subject, from, date, flags.

Search emails using himalaya filter syntax. Combine conditions with and/or (REQUIRED between every condition pair — omitting them causes parse errors). Negate any condition with not. Multi-word values need backslash-escaped spaces. Bare words default to subject-only search. Sort results with order by <date|from|to|subject> <asc|desc>. Conditions: subject, from, to, body, date (exact match), before, after, flag. Flag values: Seen, Flagged, Answered, Deleted, Draft.

Read an email message body (plain text). Use the ID from list_emails or search_emails.

Read an email message body as HTML. Useful for formatted emails.

Add or remove flags on an email. Common flags: Seen, Flagged, Answered, Deleted, Draft. Use 'add' to set flags, 'remove' to clear them.

Move an email to a different folder. Common targets: Archive, Trash, Spam, Sent, Drafts.

Export an email as formatted markdown with YAML frontmatter (date, from, to, subject, flags). Returns the markdown text — you can then save it to a file or clipboard.

Read an email and extract action items, todos, deadlines, and commitments. Returns structured action items that can be used to create tasks, reminders, or calendar events.

Generate a reply draft for an email. Returns the reply template with headers and quoted original message. Does NOT send — use send_email to send after user reviews.

Send an email template. SAFETY: requires confirm=true to actually send. Without confirm, returns a preview. Always show the user the preview and get their approval before sending with confirm=true.

Compose and send a new email (not a reply). SAFETY: requires confirm=true to actually send. Without confirm, returns a preview for user review.

List all email folders/mailboxes for an account. Returns folder names.

Create a new email folder/mailbox.

Delete an email folder/mailbox. SAFETY: requires confirm=true to actually delete. Without confirm, returns a preview warning.

List attachments for an email message. Downloads all attachments to inspect them, then returns filename, MIME type (inferred from extension), and size for each.

Download an email attachment to a temporary directory. Downloads all attachments, then returns the path to the requested file.

Extract calendar event details from an email's ICS attachment. Downloads all attachments, finds the .ics file, parses it, and returns event summary, dates, location, and organizer.

Create an event in Apple Calendar. SAFETY: requires confirm=true to actually create. Without confirm, returns a preview. macOS only.

List email threads (conversations) in a folder. Groups related emails by subject line. Returns threads sorted by most recent activity, with participant list and message count.

Read all messages in a conversation thread. Given a thread_id (the ID of the first message), fetches all related messages and returns them in chronological order. Use list_threads first to get thread IDs.

Check himalaya-mcp installation health and per-account IMAP connectivity. Use when an email tool fails to diagnose which accounts are reachable.

Copy text to the system clipboard (pbcopy on macOS, xclip on Linux). Useful for copying email content, markdown exports, or any text.

Get the number of unread emails in a folder (or across all folders). Uses himalaya's server-side filter for fast counting even in large mailboxes.

Read the raw MIME source of an email. Returns the full, unedited message including all headers. Useful for debugging, email forensics, and exporting to .eml format.

Read an email body rendered as clean markdown. For HTML emails, converts to markdown for a clean reading experience. For plain text emails, returns the body as-is.

List all flagged/starred emails. Returns envelopes with flag, subject, sender, and date. Uses server-side filtering for fast results.

Create a reminder in Apple Reminders (macOS only). Use for action items, follow-ups, and tasks extracted from email.

Snooze an email until a specified time. The email will reappear in your inbox check after the snooze period expires.

List all snoozed emails and their unsnooze times. Emails past their snooze time are returned as expired and can be revisited.