Mail.app

io.github.p-l-ta由 GitHub 帳號 p-l-ta 發布v1.3.5更新於 Oct 24, 2026

Search, read, send, and manage email via macOS Mail.app across all configured accounts.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 macOS 郵件 App 在所有已設定的帳號中搜尋、讀取、寄送與管理郵件。

可以做什麼
  • 搜尋與讀取郵件：透過郵件 App 的信封索引依條件篩選郵件、讀取完整內容、列出帳號、信箱、最近郵件與寄件者。
  • 撰寫與回覆：從已設定的帳號寄出新郵件，或依郵件 ID 回覆既有郵件。
  • 整理郵件：設定已讀與旗標狀態、在不同信箱間移動、移到垃圾桶、批次標為已讀或清空信箱。
  • 信箱與訂閱管理：建立資料夾，並從郵件中擷取取消訂閱連結。
適用情境
適合在已設定郵件 App 的 Mac 上使用，希望助理不必把郵件複製到其他地方，就能跨帳號搜尋、整理、摘要或起草並寄送郵件。
執行需求
macOS 且已安裝並設定郵件 App；Node.js 20+；支援 stdio 的 MCP 主機（如 Claude Desktop）。主機應用程式需取得完整磁碟存取權與郵件的自動化權限，伺服器程序會繼承這些權限。
安裝前請注意
可寄送、回覆、移動、刪除郵件，甚至清空整個信箱，有誤刪或誤寄風險。它會讀取本機郵件資料庫並透過 AppleScript 操作郵件 App，郵件內容會以工具結果形式傳給 MCP 主機。完整磁碟存取與自動化權限範圍很大，建議限制主機可呼叫的工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mail.app，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mail-mcp

MCP server that gives Claude (and other MCP hosts) full access to Mail.app on macOS — search, read, send, reply, flag, move, and more — across every account configured in Mail.app (iCloud, Exchange, IMAP, etc.).

Prerequisites

  • macOS (Mail.app required)
  • Node.js 20+
  • An MCP host: Claude Desktop, Amazon Quick, or any stdio MCP client

Installation

Claude Desktop — one-click install (recommended)

  1. Download mail-mcp.mcpb from the latest release
  2. Double-click the .mcpb file — Claude Desktop installs it automatically
  3. Grant the required macOS permissions (see below)

Manual / Amazon Quick / other hosts

bash
npx @p-l-ta/mail-mcp

Or install globally:

bash
npm install -g @p-l-ta/mail-mcpmail-mcp

Point your MCP host at the mail-mcp binary (stdio transport). Example config:

json
{  "mcpServers": {    "mail-app": {      "command": "npx",      "args": ["@p-l-ta/mail-mcp"]    }  }}

Required macOS permissions

Grant these to the application that runs the MCP host (Claude Desktop, Amazon Quick, etc.):

PermissionWhere to grant
Full Disk AccessSystem Settings → Privacy & Security → Full Disk Access
Automation → MailSystem Settings → Privacy & Security → Automation

The MCP server process inherits permissions from the host application that launches it.

Tools

ToolDescription
search_emailsSearch messages via the Envelope Index database with rich filters
read_emailRead the full body of a message by its RFC message-id
list_accounts_and_mailboxesList all configured accounts and mailboxes with unread counts
list_recentList recent messages in a specific mailbox
list_sendersGrouped summary of senders with message and unread counts
send_emailSend a new email from one of the configured accounts
reply_to_emailReply to an existing message by RFC message-id
set_message_flagsSet read and/or flagged status on a message
move_emailMove a message to a different mailbox
trash_emailMove a message to Deleted Messages
create_mailboxCreate a new mailbox/folder in an account
bulk_mark_readMark all messages in a mailbox and/or from a sender as read
get_unsubscribe_linkExtract unsubscribe URLs from a message's headers and body
empty_mailboxDelete every message in a mailbox at once (Junk, Trash, etc.)

How it works

  • Search & read — queries Mail's own Envelope Index SQLite database directly for fast, structured results across all accounts
  • Actions (send, reply, flag, move, trash) — driven by AppleScript automation against Mail.app, so they work even for accounts where messages aren't stored as local files

Development

bash
npm installnpm run dev          # tsx watch — live reloadnpm test             # vitest unit testsnpm run build        # compile TypeScript → dist/npm run mcpb         # build Claude Desktop extension → build/mail-mcp.mcpb

Interactive MCP testing:

bash
npm run buildnpx @modelcontextprotocol/inspector node dist/server.js

Privacy Policy

mail-mcp is a local MCP server that runs entirely on your Mac. It has no backend, no telemetry, and makes no network requests of its own.

What it accesses:

  • Mail.app's Envelope Index database (~/Library/Mail/) — read-only, used for search queries
  • Mail.app via AppleScript — to read message bodies, send mail, flag, move, and trash messages

What it does NOT do:

  • Collect, store, or transmit any data outside your Mac
  • Connect to any external server or API
  • Log message content anywhere

All email data stays on your device and is only passed to the MCP host (Claude Desktop or another client) as part of normal tool responses. You control exactly which tools Claude can invoke.

License

MIT

來源：README.md，提交 6357363

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.3.5最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分