mcpField
M
Mac Mail MCP

Mac Mail MCP

本地服务
github.com/wagamama通信协作015 周前更新
代码仓库

关于 Mac Mail MCP

Mac Mail MCP 为助手提供本地 Apple Mail 数据访问，支持基于磁盘读取邮件，并以 FTS5 对邮件正文进行全面搜索。

主要功能

  1. 01读取本地 Apple Mail 数据
  2. 02基于磁盘读取邮件
  3. 03使用 FTS5 搜索邮件正文
  4. 04监视文件并更新索引

适用场景

  1. 01搜索本地邮件正文
  2. 02按需读取 Apple Mail 数据
  3. 03保持邮件搜索索引更新

MCP 相关

作为 MCP 服务，它向 MCP 客户端开放本地 Apple Mail 数据读取与搜索能力。运行时可通过文件监视保持索引更新。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "wagamama-mac-mail": {
      "command": "uvx",
      "args": [
        "mac-mail-mcp"
      ]
    }
  }
}
启动命令uvx mac-mail-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimac-mail-mcp0.5.15

工具

8

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Apple App MCP

为 MCP 服务提供的工作区，这些服务会向助手公开本地 Apple 应用数据。

软件包

软件包状态用途
mac-mail-mcpBetaMac Mail MCP 服务，优先从磁盘读取，并支持全面覆盖的 FTS5 正文搜索。
mac-calendar-mcpAlpha只读 Mac Calendar MCP 服务，支持索引归档搜索。

快速入门

安装所需的软件包：

pipx install mac-mail-mcp
pipx install mac-calendar-mcp

构建本地索引以加快搜索：

mac-mail-mcp index --verbose
mac-calendar-mcp authorize
mac-calendar-mcp index

Calendar 授权会安装一个小型辅助应用，它具有稳定的 macOS 隐私身份。请批准一次其“完全访问日历”提示，这样终端、MCP 和计划的 launchd 重建任务都能一致地使用 EventKit。EventKit 会在该已签名应用的身份下运行；Calendar MCP 不会通过匿名的 osascript 进程执行辅助应用脚本。

生成可选配置文件：

mac-mail-mcp init
mac-calendar-mcp init

索引范围与工具默认值分别配置。使用 [index] 设置（例如 Mail 的 accounts 或 Calendar 的 calendars）来控制本地存储的内容；使用 [defaults] 设置来控制调用方未指定范围时 MCP 工具使用的范围。

Codex CLI

注册一个或两个服务：

codex mcp add mail -- mac-mail-mcp serve --watch
codex mcp add calendar -- mac-calendar-mcp serve --watch

确认注册：

codex mcp list
codex mcp get mail
codex mcp get calendar
Claude Code

在项目根目录中创建或编辑 .mcp.json：

{
  "mcpServers": {
    "mail": {
      "command": "mac-mail-mcp",
      "args": ["serve", "--watch"]
    },
    "calendar": {
      "command": "mac-calendar-mcp",
      "args": ["serve", "--watch"]
    }
  }
}

在 MCP 服务运行期间，监视模式会让索引保持最新。Mail 使用文件监视；Calendar 会在启动时同步，随后在 Calendar 的本地 SQLite 数据库文件发生变化时刷新。

对于 Claude Code 全局配置，将相同的 mcpServers 对象放入 ~/.claude/mcp.json。

开发

此仓库采用 uv 工作区结构。每个 MCP 服务都位于 packages/ 下，并拥有自己的软件包元数据、源代码、测试和 README。

git clone https://github.com/wagamama/apple-app-mcp
cd apple-app-mcp
uv sync

# All packages
uv run ruff check packages/mac-mail-mcp/src packages/mac-calendar-mcp/src
uv run pytest

# Individual packages
uv run --package mac-mail-mcp pytest packages/mac-mail-mcp/tests
uv run --package mac-calendar-mcp pytest packages/mac-calendar-mcp/tests

构建分发包：

uv build --package mac-mail-mcp
uv build --package mac-calendar-mcp

文档

文档通过 GitHub Pages 从 .github/workflows/docs.yml 部署。仓库必须在 Settings -> Pages -> Build and deployment -> Source: GitHub Actions 中配置一次 Pages。工作流会部署构建好的产物；它不会尝试创建或启用 Pages 站点，因为 GitHub 在某些仓库中会拒绝默认工作流令牌执行此操作。

致谢

此代码库源自 imdinu/apple-mail-mcp。感谢原作者和贡献者提供 Apple Mail MCP 基础，本仓库正是在此基础上构建而成。

许可证

GPL-3.0-or-later

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。