email-mcp

一支檔案的 email MCP server：用 IMAP 收信、SMTP 寄信，支援多個帳號。只依賴 Python 標準函式庫和 mcp SDK。

工具

寄出的信會 APPEND 到 IMAP 的寄件備份匣（依序試 Sent Items、Sent、INBOX.Sent、[Gmail]/Sent Mail），所以在一般郵件軟體裡也看得到。

Related MCP server: Email SMTP/IMAP MCP Server

安裝

需要 Python 3.10 以上。

git clone https://github.com/ChenLiangChong/email-mcp.git
cd email-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

設定

在 MCP 用戶端的設定檔（Claude Code 是專案的 .mcp.json）加上，路徑請用絕對路徑：

{
  "mcpServers": {
    "email": {
      "command": "/path/to/email-mcp/.venv/bin/python",
      "args": ["/path/to/email-mcp/server.py"],
      "env": {
        "EMAIL_ACCOUNTS": "[{\"name\":\"work\",\"email\":\"you@example.com\",\"password\":\"your-app-password\",\"imap_host\":\"imap.example.com\",\"smtp_host\":\"smtp.example.com\"}]"
      }
    }
  }
}

EMAIL_ACCOUNTS 是一個 JSON 陣列，每個帳號的欄位：

工具的 account 參數可以填 name 或 email，留空就用第一個帳號。IMAP 和 SMTP 都走 SSL。

注意

• 密碼不要進版控。 有密碼的 .mcp.json 請加進 .gitignore，或改成啟動時從系統鑰匙圈讀出來再塞進環境變數。Gmail 這類信箱請用應用程式密碼。

• uid 是 IMAP UID，信件被刪除後不會位移；指到已不存在的信會回錯誤，不會對到別封。只接受單一數字，1:* 這類範圍會被擋掉。

• email_delete 用的是 EXPUNGE，會一併清掉同一個資料夾裡其他已被標記 \Deleted 的信。

• email_send、email_reply、email_delete 會真的寄信和刪信，建議在用戶端把這三個工具設成每次都要確認。

授權

MIT