AI导哈

邮件管理协议服务

Apple Mail MCP是一个基于AI助手的邮件管理协议服务器，支持读取、发送、搜索和管理邮件。

  • by Jacob101mcd
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Jacob101mcd/apple-mail-mcp-v2

使用说明

苹果邮件MCP

macOS上Apple Mail的模型上下文协议（MCP）服务器。直接通过人工智能助手阅读、发送、搜索和管理电子邮件。

特征

  • 账户管理：列出邮件帐户和邮箱
  • 电子邮件检索：获取未读、最近或特定的电子邮件
  • 搜索：按发件人、主题、内容或日期搜索电子邮件
  • 撰写和发送：使用收件人、抄送和密件抄送发送新电子邮件
  • 回复：回复现有电子邮件
  • 组织：标记为已读/未读、删除、在邮箱之间移动
  • 统计：获取每个帐户/邮箱的未读计数

先决条件

  • 已配置Apple Mail的macOS
  • Node.js 18或更高版本
  • Apple Mail必须至少配置一个帐户

安装

npm install -g apple-mail-mcp

或者克隆并在本地构建：

git clone https://github.com/thomasvincent/apple-mail-mcp.git
cd apple-mail-mcp
npm install
npm run build

配置

添加到您的MCP客户端配置中（例如，Claude Desktop位于 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "apple-mail": {
      "command": "node",
      "args": ["/path/to/apple-mail-mcp/dist/index.js"]
    }
  }
}

发展

构建项目：

npm run build

开发观察模式：

npm run dev

运行门楣：

npm run lint

格式代码：

npm run format

测试

运行测试：

npm test

测试观察模式：

npm run test:watch

可用工具

帐户和邮箱管理

  • mail_get_accounts -列出所有已配置的邮件帐户
  • mail_get_mailboxes -列出帐户的邮箱

电子邮件检索

  • mail_get_unread -获取未读电子邮件（可选择按帐户/邮箱筛选）
  • mail_get_recent -获取具有可配置限制的最近电子邮件
  • mail_get_email -通过ID获取特定电子邮件

搜索

  • mail_search -按发件人、主题、内容或日期范围搜索电子邮件

撰写和发送

  • mail_send -发送一封新电子邮件（可选抄送/密送）
  • mail_reply -回复现有电子邮件

组织

  • mail_mark_read -将电子邮件标记为已读
  • mail_mark_unread -将电子邮件标记为未读
  • mail_delete -删除电子邮件
  • mail_move -将电子邮件移动到其他邮箱

公用事业

  • mail_unread_count -获取未读电子邮件计数
  • mail_open -打开Apple Mail应用程序
  • mail_check -检查新电子邮件

权限

MCP服务器使用AppleScript与Apple Mail交互。首次使用时，您可能需要在“系统首选项”>“安全与隐私”>“隐私”>《自动化》中授予自动化权限。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

作者

托马斯·文森特

相关 MCP