mcp-mail

Overview

The MCP Mail Tool is a comprehensive email management solution built on the Model Context Protocol that allows AI models to interact with email services through standardized APIs. It provides a wide range of functionality including email sending (text, HTML, with attachments), inbox management, advanced search capabilities, attachment handling, and contact management. The tool acts as a bridge between AI systems and email servers, using nodemailer for SMTP operations and node-imap for IMAP operations, ensuring secure local processing of sensitive email data.

Try asking AI

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

• send_email

  Send an email with support for text, HTML, and attachments

  Try:Send an email to john@example.com with subject 'Meeting tomorrow' and body 'Let's meet at 10 AM'Try:Send a newsletter to all customers with HTML content and attachments
• list_folders

  Get a list of email folders in the mailbox

  Try:List all my email foldersTry:Show me my mailbox folders
• list_emails

  List emails in a specific folder with filtering options

  Try:Show me the latest 5 emails in my inboxTry:List all emails from the 'Work' folderTry:Find emails from sender@domain.com in my inbox
• get_email_details

  Get detailed information about a specific email

  Try:Show me details for email with UID 1234Try:Get the full content of the email about the project update
• search_emails

  Advanced search for emails using multiple criteria

  Try:Search for emails containing 'invoice' from last monthTry:Find emails with subject 'urgent' sent to my boss
• mark_email_read

  Mark an email as read

  Try:Mark email UID 1234 as readTry:Mark the email about the meeting as read
• delete_email

  Delete a specific email

  Try:Delete email with UID 1234Try:Remove the spam email I received yesterday
• move_email

  Move an email to a different folder

  Try:Move email UID 1234 to the 'Archive' folderTry:Move the project update email to 'Work' folder
• list_attachments

  List attachments in a specific email

  Try:Show me attachments in email UID 1234Try:List all attachments in the email about the report
• download_attachment

  Download an attachment from a specific email

  Try:Download the PDF attachment from email UID 1234Try:Get the image file attached to the project email
• list_contacts

  Get a list of contacts extracted from emails

  Try:Show me all my contactsTry:List contacts I've emailed in the last week
• search_contacts

  Search for contacts by name or email

  Try:Find contacts with 'John' in their nameTry:Search for contacts with domain '@company.com'

Comparable tools

Installation

npx -y @smithery/cli install @shuakami/mcp-mail --client claude

git clone https://github.com/shuakami/mcp-mail.git
cd mcp-mail
npm install
npm run build

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/Users/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "SMTP_HOST": "smtp.qq.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "SMTP_USER": "your.email@qq.com",
        "SMTP_PASS": "your-app-specific-password",
        "IMAP_HOST": "imap.qq.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "IMAP_USER": "your.email@qq.com",
        "IMAP_PASS": "your-app-specific-password",
        "DEFAULT_FROM_NAME": "Your Name",
        "DEFAULT_FROM_EMAIL": "your.email@qq.com"
      }
    }
  }
}

FAQ

What email services are supported?

The tool supports any email service that uses standard SMTP and IMAP protocols, including QQ Mail, Gmail, Outlook, and others.

Is my email data secure?

Yes, all email operations are processed locally without forwarding sensitive information through third-party servers.

Compare mcp-mail with