
Email Mcp
A full-featured email client for AI assistants that goes well beyond basic read/send. Connects to any IMAP/SMTP provider with TLS and handles multiple accounts simultaneously. The 47 tools cover the entire email lifecycle: reading, searching, composing, sending replies and forwards, managing drafts and templates, scheduling future sends, and bulk label operations with provider-aware logic for Gmail, Outlook, and others. The IMAP IDLE watcher monitors inboxes in real time and can run AI triage rules on incoming mail, triggering desktop notifications or webhooks. Also extracts calendar events from ICS attachments and provides email analytics. OAuth2 support for Gmail and Microsoft 365 is experimental. Setup wizard auto-detects server settings for common providers.
- GitHub stars
- 147
- tools
- 30
- transport
- STDIO
- last updated
- Oct 10, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
list_accountsList all configured email accounts
List all configured email accounts
No parameter schema in public metadata yet.
list_mailboxesList folders with unread counts and special-use flags
List folders with unread counts and special-use flags
No parameter schema in public metadata yet.
list_emailsPaginated email listing with date, sender, subject, and flag filters; marks bulk mail; optional body preview
Paginated email listing with date, sender, subject, and flag filters; marks bulk mail; optional body preview
No parameter schema in public metadata yet.
get_emailRead full email content with attachment metadata and bulk-mail classification (HTML converted to readable text by default)
Read full email content with attachment metadata and bulk-mail classification (HTML converted to readable text by default)
No parameter schema in public metadata yet.
get_emailsFetch full content of multiple emails in a single call (max 20); same bulk markers
Fetch full content of multiple emails in a single call (max 20); same bulk markers
No parameter schema in public metadata yet.
get_email_statusGet read/flag/label state of an email without fetching the body
Get read/flag/label state of an email without fetching the body
No parameter schema in public metadata yet.
search_emailsSearch by keyword across subject, sender, and body; same bulk markers and optional preview as list_emails
Search by keyword across subject, sender, and body; same bulk markers and optional preview as list_emails
No parameter schema in public metadata yet.
download_attachmentDownload an email attachment by filename or MIME part id, base64-encoded or (if configured) saved to the server's attachment download directory
Download an email attachment by filename or MIME part id, base64-encoded or (if configured) saved to the server's attachment download directory
No parameter schema in public metadata yet.
find_email_folderDiscover the real folder(s) an email resides in (resolves virtual folders)
Discover the real folder(s) an email resides in (resolves virtual folders)
No parameter schema in public metadata yet.
extract_contactsExtract unique contacts from recent email headers
Extract unique contacts from recent email headers
No parameter schema in public metadata yet.
get_threadReconstruct a conversation thread via References/In-Reply-To; same bulk markers
Reconstruct a conversation thread via References/In-Reply-To; same bulk markers
No parameter schema in public metadata yet.
list_templatesList available email templates
List available email templates
No parameter schema in public metadata yet.
get_email_statsEmail analytics — volume, top senders, daily trends
Email analytics — volume, top senders, daily trends
No parameter schema in public metadata yet.
check_healthConnection health, latency, quota, and IMAP capabilities
Connection health, latency, quota, and IMAP capabilities
No parameter schema in public metadata yet.
send_emailSend a new email (plain text or HTML, CC/BCC)
Send a new email (plain text or HTML, CC/BCC)
No parameter schema in public metadata yet.
reply_emailReply with proper threading (In-Reply-To, References)
Reply with proper threading (In-Reply-To, References)
No parameter schema in public metadata yet.
forward_emailForward with original content quoted
Forward with original content quoted
No parameter schema in public metadata yet.
save_draftSave an email draft to the Drafts folder
Save an email draft to the Drafts folder
No parameter schema in public metadata yet.
send_draftSend an existing draft and remove from Drafts
Send an existing draft and remove from Drafts
No parameter schema in public metadata yet.
apply_templateApply a template with variable substitution
Apply a template with variable substitution
No parameter schema in public metadata yet.
schedule_emailSchedule an email for future delivery
Schedule an email for future delivery
No parameter schema in public metadata yet.
list_scheduledList scheduled emails by status
List scheduled emails by status
No parameter schema in public metadata yet.
cancel_scheduledCancel a pending scheduled email
Cancel a pending scheduled email
No parameter schema in public metadata yet.
move_emailMove email between folders
Move email between folders
No parameter schema in public metadata yet.
delete_emailMove to Trash or permanently delete
Move to Trash or permanently delete
No parameter schema in public metadata yet.
mark_emailMark as read/unread, flag/unflag
Mark as read/unread, flag/unflag
No parameter schema in public metadata yet.
bulk_actionBatch operation on up to 100 emails
Batch operation on up to 100 emails
No parameter schema in public metadata yet.
create_mailboxCreate a new mailbox folder
Create a new mailbox folder
No parameter schema in public metadata yet.
rename_mailboxRename an existing mailbox folder
Rename an existing mailbox folder
No parameter schema in public metadata yet.
delete_mailboxPermanently delete a mailbox and contents
Permanently delete a mailbox and contents
No parameter schema in public metadata yet.
Sponsors
Readme
Email MCP Server
An MCP (Model Context Protocol) server providing comprehensive email capabilities via IMAP and SMTP.
Details
- Repository
- github.com/codefuturist/email-mcp
- Category
- Communication & Messaging
- Package
@codefuturist/email-mcp- Transport
- STDIO
- Registry
- MCP registry, active