codefuturist avatar

Email Mcp

codefuturist/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 tools

Public 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

standard-readme compliant license npm version npm downloads CI

An MCP (Model Context Protocol) server providing comprehensive email capabilities via IMAP and SMTP.


View the full README on GitHub

Details

Repository
github.com/codefuturist/email-mcp
Category
Communication & Messaging
Package
@codefuturist/email-mcp
Transport
STDIO
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1n24q02m avatarEmailn24q02m/emailIMAP/SMTP email for AI agents -- read, send, organize, and manage attachments across accounts.37stars
2n24q02m avatarTelegram MCPn24q02m/telegramTelegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.11stars
3virtualsms-io avatarSmsvirtualsms-io/mcp-serverReal SIM numbers for AI agents: SMS verification, rentals, proxies, cloud browser, x402 deposits.0stars
4initechsoftware avatarWhatsApp MCP by TimelinesAIinitechsoftware/whatsapp-mcp-by-timelinesaiAsk questions across your WhatsApp inbox from Claude, ChatGPT, Cursor or any MCP client.5stars
5boutquin avatarEmail (IMAP/SMTP)boutquin/mcp-server-emailMulti-account IMAP/SMTP email server with 22 tools for reading, sending, searching, and organizing.2stars
6faithk7 avatarFaithk7 Gmail Mcpfaithk7/gmail-mcpManage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…0stars