email-mcp

Overview

The email-mcp server provides comprehensive email management capabilities through the Model Context Protocol. It implements both IMAP for reading emails and SMTP for sending, supporting multiple email accounts simultaneously. The server exposes 47 tools, 7 prompts, and 6 resources, including features like email scheduling, calendar extraction, provider-aware label management, and real-time IMAP IDLE watcher with AI-powered triage. It supports OAuth2 authentication for Gmail and Microsoft 365 (experimental) and offers both CLI and Docker deployment options.

Try asking AI

After installing, here are 8 things you can ask your AI assistant:

• list_emails

  List emails in a mailbox with filtering options

  Try:Show me my latest emailsTry:Find emails from JohnTry:List unread messages in my inbox
• send_email

  Send a new email with attachments

  Try:Send an email to team@company.comTry:Forward this email to SarahTry:Draft a meeting reminder
• reply_email

  Reply to an existing email

  Try:Reply to the last email I receivedTry:Accept the meeting invitationTry:Ask for more details about their proposal
• schedule_email

  Schedule an email to be sent at a future time

  Try:Send this email tomorrow morningTry:Schedule a follow-up for next weekTry:Delay this reply until Friday
• search_emails

  Search for emails using complex queries

  Try:Find emails with attachment from last monthTry:Search for invoices from ACME CorpTry:Show me all emails about project Phoenix
• move_email

  Move an email between mailboxes

  Try:Move this email to the Archive folderTry:Put this newsletter in the Marketing folderTry:Move this message to Trash
• add_label

  Add a label to an email

  Try:Label this email as 'Important'Try:Tag this message with 'Follow-up'Try:Mark this as 'Urgent'
• extract_calendar

  Extract calendar events from email content

  Try:Add the meeting from this email to my calendarTry:What meetings are scheduled for tomorrow?Try:Create events from these flight confirmations
• create_draft

  Create a new email draft

  Try:Start drafting a project proposalTry:Create a template for client emailsTry:Save this as a draft for later
• manage_account

  Manage email account settings

  Try:Add my new work email accountTry:Switch to my personal accountTry:Edit my signature
• realtime_monitor

  Monitor mailbox for new emails in real-time

  Try:Watch my inbox for important emailsTry:Notify me when Sarah sends an emailTry:Alert me when a client responds
• analyze_email

  Analyze email content for insights or summaries

  Try:Summarize this long email threadTry:What are the action items in this message?Try:Extract key points from this report

Comparable tools

Installation

# Run directly
npx @codefuturist/email-mcp setup

# Or install globally
npm install -g @codefuturist/email-mcp

docker pull ghcr.io/codefuturist/email-mcp:latest

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "@codefuturist/email-mcp", "stdio"]
    }
  }
}

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "@codefuturist/email-mcp", "stdio"],
      "env": {
        "MCP_EMAIL_ADDRESS": "you@gmail.com",
        "MCP_EMAIL_PASSWORD": "your-app-password",
        "MCP_EMAIL_IMAP_HOST": "imap.gmail.com",
        "MCP_EMAIL_SMTP_HOST": "smtp.gmail.com"
      }
    }
  }
}

FAQ

What email providers are supported?

The server auto-detects settings for Gmail, Outlook, Yahoo, iCloud, Fastmail, ProtonMail, Zoho, and GMX. Custom IMAP/SMTP servers are also supported.

Is OAuth2 authentication available?

Yes, OAuth2 is available for Gmail and Microsoft 365 as an experimental feature. Token refresh and provider-specific flows may require additional testing.

How do I set up multiple accounts?

Use `email-mcp account add` to add accounts interactively, or manually configure multiple account sections in the TOML config file at ~/.config/email-mcp/config.toml.

Compare email-mcp with