Email MCP server

Read from the package source without running it. The installed server may list more.

• add_label

  Add a label to an email.

• add_to_calendar
• analyze_email_for_schedulingwrite action
• apply_template

  Apply an email template with variable substitution. Use action "preview" to see the result, "draft" to save as draft, or "send" to send immediately.

• bulk_action

  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.

• cancel_scheduledwrite action

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

• check_calendar_permissions
• check_clipboard_setup

  Diagnose the clipboard integration used for caught verification codes: platform

• check_health

  Check connection health, quota, and capabilities for email accounts, plus local cache

• check_notification_setup

  Diagnose desktop notification support on this platform.

• configure_alertswrite action

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

• configure_verificationwrite action

  Update [settings.verification] at runtime — changes take effect immediately,

• create_labelwrite action

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

• create_mailboxwrite action

  Create a new mailbox (folder). Use '/' as separator for nested folders (e.g., 'Work/Projects'). Use list_mailboxes to see existing folders.

• create_reminderwrite action
• delete_emailwrite action

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

• delete_labelwrite action

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

• delete_mailboxwrite action

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

• download_attachment

  Download an email attachment by filename or part id. First use get_email to see available

• extract_calendar

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

• extract_contacts

  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_email_folderwrite action

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

• forward_emailwrite action

  Forward an email to new recipients with optional additional message. The original is converted

• get_emailwrite action

  Get the full content of a specific email by ID.

• get_email_statswrite action

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

• get_email_statuswrite action

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

• get_emails

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

• get_hooks_config

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

• get_thread

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

• get_verification_code

  Find the newest verification code (OTP/2FA) or sign-in magic link in recent mail,

• get_watcher_status

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

• list_accounts

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

• list_calendars
• list_emails

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

• list_events
• list_labels

  List available labels for an email account.

• list_mailboxes

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

• list_presets

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

• list_reminders
• list_scheduled

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

• list_templates

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

• mark_emailwrite action

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

• move_emailwrite action

  Move an email to a different mailbox folder.

• remove_labelwrite action

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

• rename_mailbox

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

• reply_emailwrite action

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

• save_draft

  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_emailwrite action

  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

  Search emails by keyword across subject, sender, and body — and, where the local

• send_draftwrite action

  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_emailwrite action

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

• test_notificationwrite action

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

• Code scan233 source files scanned13/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 1 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

74/100

higher than 42% of 915 Email servers

Tools

52

the typical Email server has 8

Tools that change things

44%

typical: 25%. Fewer write tools means less an agent can break

GitHub stars

149

more than 95% of 502 Email servers

Downloads a week

1,035

more than 93% of 270 Email servers with a package

Email: common questions

Is Email MCP server safe?

Mostly: it is graded B (74/100). Read the Email safety report

How do I install Email?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Email need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Email maintained?

The last commit was 8 days ago (2026-11-07). The latest release is v0.6.0.

What can I use instead of Email?

Servers from other publishers that do the same job: Mailoo - Email MCP Server, Imap MCP server and Fluxmail MCP server. Compare all Email alternatives.

How does Email compare with other Email MCP servers?

safety score 74/100 (higher than 42% of 915 Email servers); tools 52 (the typical Email server has 8); tools that change things 44% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.