mac-mail-mcp MCP server that reads your Apple Mail.app data directly from the local SQLite database. No OAuth, no API keys — just local file access. Works…
mac-mail-mcp MCP server that reads your Apple Mail.app data directly from the local SQLite database. No OAuth, no API keys — just local file access. Works with any email account configured in Mail.app (Gmail, Outlook/Exchange, iCloud, IMAP). Tools ToolDescriptionlist_accountsList all email accounts configured in Mail.applist_foldersList mailbox folders with message countssearchSearch by subject, sender, date range, folderget_emailGet full email with body (from.emlx files)get_threadGet all messages in a conversationunread_countUnread counts per folder/account Setup Shellcd /path/to/mac-mail-mcp npm install npm run build Global (all Claude Code sessions) Add to ~/.claude.json: JSON{ "mcpServers": { "mac-mail": { "command": "node", "args": ["/path/to/mac-mail-mcp/dist/index.js"] } } } Project-only Add a.mcp.json in your project root: JSON{ "mcpServers": { "mac-mail": { "command": "node", "args": ["/path/to/mac-mail-mcp/dist/index.js"] } } } How it works Mail.app stores all email metadata in a SQLite database at ~/Library/Mail/V*/MailData/Envelope Index and message bodies as.emlx files. This server reads both to give you full access to your email. Requirements macOS with Mail.app configured Node.js 18+ Full Disk Access may be required for the process reading the database Limitations Read-only — cannot send, move, or delete emails Message bodies are only available for emails Mail.app has downloaded locally Mail.app must be configured with the accounts you want to access
本頁屬於 OpenClaw Skills 學習體系，涵蓋技能安裝、分類導覽與實戰連結。