邮件管理服务器

Apple Mail MCP服务器是一个用于集成Apple Mail与Claude Desktop和Claude Code的邮件管理工具,提供搜索、阅读、管理邮件等功能。

  • by mggrim
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mggrim/apple-mail-mcp-server

使用说明

苹果邮件MCP服务器

MCP(模型上下文协议)服务器,用于将Apple Mail与Claude Desktop和Claude Code集成。

特性

  • 🔍 按查询、发件人、主题、邮箱搜索电子邮件
  • 📧 阅读完整的电子邮件详细信息,包括附件
  • 📁 列出并管理邮箱
  • ✉️ 创建草稿并发送电子邮件
  • 📌 将电子邮件标记为已读/未读
  • 🔄 在文件夹之间移动电子邮件
  • 👤 列出电子邮件帐户

安装

在你的第一台Mac上

git clone <your-repo-url>
cd apple-mail-mcp-server
npm install
npm run build

配置Claude桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-mail": {
      "command": "node",
      "args": ["<path-to-repo>/apple-mail-mcp-server/dist/index.js"],
      "env": {
        "TRANSPORT": "stdio"
      }
    }
  }
}

配置Claude代码

增添 ~/.config/claude/config.json:

{
  "mcpServers": {
    "apple-mail": {
      "command": "node",
      "args": ["<path-to-repo>/apple-mail-mcp-server/dist/index.js"],
      "env": {
        "TRANSPORT": "stdio"
      }
    }
  }
}

在其他Mac上

  1. 将存储库克隆到 同一条路 在每台Mac上(推荐)
  2. 跑 npm install && npm run build
  3. 从第一台Mac复制您的Claude配置,或者更新路径(如果不同)

发展

npm run dev     # Run with auto-reload
npm run build   # Compile TypeScript
npm start       # Run the server

可用工具

  • apple_mail_search -搜索电子邮件
  • apple_mail_get_email -获取完整的电子邮件详细信息
  • apple_mail_list_mailboxes -列出所有邮箱
  • apple_mail_get_attachments -列出电子邮件附件
  • apple_mail_move_email -将电子邮件移动到文件夹
  • apple_mail_mark_read -标记为已读/未读
  • apple_mail_create_draft -创建电子邮件草稿
  • apple_mail_send_email -立即发送电子邮件
  • apple_mail_list_accounts -列出所有帐户

需求

  • macOS与Apple Mail
  • Node.js>=18
  • 克劳德桌面或克劳德代码

许可证

麻省理工学院