shuakami/mcp-mail

View on GitHub ↗

📧 MCP Mail Tool - AI-powered email management tool | 基于 MCP 的智能邮件管理工具

48 ★9 forksTypeScriptUpdated 10mo ago

What you need to know

MCP-based email tool that lets AI models send, read, and manage email through a standardized interface (Mail MCP). Supports plain-text and HTML emails, attachments, mass mail, folder listing, advanced multi-condition search, read/unread and delete/move management, attachment preview/download, and contact extraction with frequency analysis. Built with nodemailer, node-imap, and mailparser (Node.js 18+/TypeScript 5), bridged to MCP via a Python script (pythonw). Configured with SMTP/IMAP env vars. ISC license.

Install

npx -y @smithery/cli install @shuakami/mcp-mail --client claude
git clone https://github.com/shuakami/mcp-mail.git && npm install && npm run build

Key features

  • ✓Send text/HTML emails with attachments and mass send
  • ✓Folder list, mail list, advanced search, and mail details
  • ✓Mark read/unread, delete, and move mails
  • ✓Attachment listing, download, and content preview
  • ✓Contact extraction from mail history with frequency analysis
  • ✓Content-range viewing for large mails
Clients: Cursor · Claude Desktop

Reviewed 2026-08-11

Topics

aiai-toolsanthropicautomationchatgptcursordeveloper-toolsemailemail-automationemail-clientimapmail-clientmail-servicemcpmodel-context-protocolnodejsopenaiproductivitysmtptypescript
Stars
48★
Forks
9
Language
TypeScript
License
—
Created
2025-03-20
Last push
2025-11-12