Mac Mail MCP

Mac Mail MCP是一个专门用于苹果邮件应用集成的Model Context Protocol服务器。

功能

• 获取未读邮件
• 发送邮件
• 管理邮件账户和邮箱
• 获取最新邮件

安装

npm install

开发

bun run dev

构建

bun run build

重要说明

邮件账户和邮箱名称

在使用此MCP服务器时，请注意以下几点：

1. 账户名称：使用Mac邮件应用中显示的确切账户名称

   • 例如："谷歌", "iCloud", "Outlook" 等

2. 邮箱名称：不同账户的邮箱名称可能不同

   • Gmail账户："INBOX", "已发邮件", "草稿", "垃圾邮件" 等
   • 智能邮箱："收件箱", "VIP", "未读" 等

3. 获取正确名称的方法：

   // 获取所有账户
   {"name": "mail_accounts", "arguments": {}}
      
   // 获取特定账户的邮箱
   {"name": "mail_mailboxes", "arguments": {"account": "谷歌"}}

权限要求

确保以下权限已启用：

• Mac邮件应用的自动化权限
• 终端或Node.js的辅助功能权限
• 系统偏好设置 > 安全性与隐私 > 隐私 > 自动化

使用

该MCP服务器提供以下工具：

mail_unread

获取未读邮件

{
  "name": "mail_unread",
  "arguments": {
    "account": "谷歌",      // 可选，账户名
    "mailbox": "INBOX",    // 可选，邮箱名  
    "limit": 10            // 可选，邮件数量
  }
}

// mail_search 工具已移除

mail_latest

获取最新邮件

{
  "name": "mail_latest",
  "arguments": {
    "account": "谷歌",      // 可选，不提供则使用第一个账户
    "limit": 5             // 可选，默认5封
  }
}

mail_send

发送邮件

{
  "name": "mail_send",
  "arguments": {
    "to": "[email protected]",     // 必需
    "subject": "邮件主题",           // 必需
    "body": "邮件内容",             // 必需
    "cc": "[email protected]",           // 可选
    "bcc": "[email protected]"          // 可选
  }
}

mail_accounts

列出所有邮件账户

{
  "name": "mail_accounts",
  "arguments": {}
}

mail_mailboxes

列出邮箱

{
  "name": "mail_mailboxes",
  "arguments": {
    "account": "谷歌"       // 可选，不提供则列出所有邮箱
  }
}

故障排除

常见问题

1. "No emails found"

   • 检查账户名称是否正确
   • 检查邮箱名称是否正确（Gmail使用"INBOX"而非"收件箱"）
   • 确认Mail应用正在运行且已同步

2. 权限错误

   • 在系统偏好设置中启用自动化权限
   • 重启终端或IDE
   • 重新启动Mac邮件应用

3. 账户找不到

   • 使用mail_accounts工具查看可用账户
   • 使用完整的账户名称（包括特殊字符）

调试建议

1. 首先运行mail_accounts确认账户名称
2. 运行mail_mailboxes确认邮箱名称
3. 使用正确的名称重试操作

许可证

MIT