io.github.codefuturist/email-mcp

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

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.

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

Cancel a scheduled email. Removes it from the queue and deletes the associated draft.

Download an email attachment by filename. First use get_email to see available attachments and their filenames. Returns base64-encoded content for files ≤5MB.

Reconstruct a full email conversation thread by following References and In-Reply-To headers.

Check connection health, quota, and capabilities for email accounts. Useful for diagnosing issues.

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

Batch operation on multiple emails by UID list. Supports mark_read, mark_unread, flag, unflag, move, and delete. Max 100 IDs per call. Returns success/failure counts.

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.

Send a new email. Supports plain text or HTML body, CC, and BCC.

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

Forward an email to new recipients with optional additional message. Original email is quoted below.

Find which real mailbox folder(s) an email belongs to.

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

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

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

Diagnose desktop notification support on this platform.

Send a test desktop notification to verify that OS permissions are correctly configured.

Update alert/notification settings at runtime. Changes take effect immediately.

Create a new mailbox (folder). Use

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

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

List all available email templates. Templates are TOML files in ~/.config/email-mcp/templates/ with {{variable}} placeholders for subject and body.

Apply an email template with variable substitution. Use action

List available labels for an email account.

Add a label to an email.

Remove a label from an email. For ProtonMail, this removes the email from the label folder.

Create a new label. For ProtonMail, creates a folder under Labels/.

Delete a label. For ProtonMail, deletes the label folder.

List emails in a mailbox with optional filters. Returns paginated results with metadata

Get the full content of a specific email by ID.

Fetch the full content of multiple emails in a single call (max 20).

Get the current read/flag/label state of an email without fetching its body.

Search emails by keyword across subject, sender, and body.

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

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.

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.

Move an email to a different mailbox folder.

Delete an email. By default moves to Trash. Set permanent=true for permanent deletion (⚠️ irreversible).

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

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