mac邮件mcp
MCP服务器，直接从本地SQLite数据库读取您的Apple Mail.app数据。没有OAuth，没有API密钥，只有本地文件访问。
适用于Mail.app中配置的任何电子邮件帐户（Gmail、Outlook/Exchange、iCloud、IMAP）。
工具
| 工具 | 说明 |
|---|---|
list_accounts | 列出Mail.app中配置的所有电子邮件帐户 |
list_folders | 列出包含邮件计数的邮箱文件夹 |
search | 按主题、发件人、日期范围、文件夹搜索 |
get_email | 获取包含正文的完整电子邮件（来自.emlx文件） |
get_thread | 获取对话中的所有消息 |
unread_count | 每个文件夹/帐户的未读计数 |
设置
cd /path/to/mac-mail-mcp
npm install
npm run build全局（所有Claude Code会话）
添加 ~/.claude.json:
{
"mcpServers": {
"mac-mail": {
"command": "node",
"args": ["/path/to/mac-mail-mcp/dist/index.js"]
}
}
}仅限项目
添加一个 .mcp.json 在项目根目录中：
{
"mcpServers": {
"mac-mail": {
"command": "node",
"args": ["/path/to/mac-mail-mcp/dist/index.js"]
}
}
}运作原理
Mail.app将所有电子邮件元数据存储在SQLite数据库中 ~/Library/Mail/V*/MailData/Envelope Index 以及消息体 .emlx 文件夹。此服务器读取这两个信息，以便您完全访问您的电子邮件。
需求
- 已配置Mail.app的macOS
- Node.js 18+
- 读取数据库的进程可能需要完全磁盘访问权限
局限性
- 只读--无法发送、移动或删除电子邮件
- 邮件正文仅适用于Mail.app在本地下载的电子邮件
- Mail.app必须配置您要访问的帐户