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: quote them or backslash-escape the spaces. Sort results with order by <date|from|to|subject> <asc|desc>. Conditions: subject, from, to, body, date (exact day), after (strictly after), flag. Flag values: seen, answered, flagged, draft, deleted. On himalaya v2 every word must belong to a condition (no bare words: use subject <word>), and there is no before: use not after <date>.

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. Flags: Seen, Flagged, Answered, Draft (and Deleted on himalaya v1 only; on v2 delete by moving to the trash with move_email). 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. With save_draft=true, saves the message (attachments included) to the drafts mailbox instead of sending: no confirm needed, nothing is sent (requires himalaya v2).

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 (folder + envelope surfaces). 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.