claws-mail-mcp-plugin

claws-mail-mcp-plugin

原生 Claws Mail 插件，可将正在运行的邮件客户端作为 MCP 服务提供。

插件运行在 Claws Mail 内部，并提供仅限本地回环的 HTTP 端点（通过 MCP 使用 JSON-RPC，并受持有者令牌保护）。任何支持 MCP 的 AI 工具都可以通过你已配置的账户读取文件夹和邮件、搜索、撰写、回复、转发、管理文件夹和标记，以及收发邮件。端点、端口、令牌和只读模式在 Claws Mail 配置目录中的 mcp_pluginrc 里设置；每次启动时，插件都会在同一位置将可直接粘贴的客户端配置写入 mcp_client.json。

---

安装插件

预编译二进制文件随每个发行版一同提供，每种操作系统和受支持的 Claws Mail 版本各一个（例如 mcp-linux-claws4.3.1.so、mcp-windows-claws4.3.0.dll）。选择与你的 Claws Mail 版本和操作系统匹配的文件，然后：

1. 将其保存到你选择的文件夹中，例如 ~/.claws-mail/plugins，或 Windows 上的 %APPDATA%\Claws-mail\plugins，并命名为 mcp.so 或 mcp.dll。文件名可以任意选择，但不能以 _plugin.so 或 _plugin.dll 结尾：Claws Mail 启动时不会加载此类文件，并会将其从插件列表中移除。
2. 在 Claws Mail 中，打开 Configuration > Plugins，点击 Load... 并选择该文件。

Claws Mail 每次启动时都会重新加载此插件。

如需从源代码构建，请参阅构建。

---

连接 AI 工具

加载插件后，它会将实际端点 URL 和持有者令牌写入 Claws Mail 配置目录中的 mcp_client.json。根据你使用的工具，选择以下相应方法并使用这两个值。服务仅限本地回环（127.0.0.1），因此只有在运行 Claws Mail 的同一台机器上的 AI 工具才能访问它。

Claude Code

claude mcp add --transport http claws-mail http://127.0.0.1:8765/mcp \
  --header "Authorization: Bearer <TOKEN>"

Claude Desktop

进入 Settings > Developer > Edit Config，然后合并 packaging/claude/mcp.json 中的配置 （填写 <TOKEN>）。请勿通过“Add custom connector”界面添加此服务： 该流程会从 Anthropic 的服务器发起连接，而非从你的机器发起，因此 无法访问本地回环地址。

VS Code / GitHub Copilot Chat

code --add-mcp "{\"name\":\"claws-mail\",\"type\":\"http\",\"url\":\"http://127.0.0.1:8765/mcp\",\"headers\":{\"Authorization\":\"Bearer <TOKEN>\"}}"

或者将 packaging/vscode/mcp.json 复制到 .vscode/mcp.json；系统会提示你输入令牌， 而不是将其保存在文件中。

Codex CLI

export CLAWS_MCP_TOKEN=<TOKEN>
codex mcp add claws-mail --url http://127.0.0.1:8765/mcp --bearer-token-env-var CLAWS_MCP_TOKEN

这与 packaging/codex/config.toml 相对应，Codex 会从 ~/.codex/config.toml 读取该文件。

MCP 注册表

该插件已列入 MCP 注册表，名称为 io.github.it-atelier-gn/claws-mail-mcp-plugin。注册信息不包含连接详情；请安装插件，并按照上述说明连接你的工具。

---

构建

需要 Meson、Ninja、C 编译器和 Claws Mail 开发文件 （GTK3、GLib、GnuTLS、libgcrypt；Linux 上还需要 enchant）。

Linux

安装依赖项（以 Debian/Ubuntu 为例）：

sudo apt-get install build-essential meson ninja-build pkg-config \
  libgtk-3-dev libglib2.0-dev libgnutls28-dev libgcrypt20-dev libenchant-2-dev

如果系统上尚无 claws-mail pkg-config 文件，请按以下方式构建：

PREFIX="$PWD/.claws-sdk" ci/build-claws-sdk.sh
export PKG_CONFIG_PATH="$PWD/.claws-sdk/lib/pkgconfig"

然后配置并构建：

meson setup build
meson compile -C build
meson test -C build

插件将构建在 build/mcp.so。

Windows（MSYS2）

安装 MINGW64 工具链和依赖项：

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-meson mingw-w64-x86_64-ninja \
  mingw-w64-x86_64-pkgconf mingw-w64-x86_64-gtk3 mingw-w64-x86_64-glib2 \
  mingw-w64-x86_64-gnutls mingw-w64-x86_64-libgcrypt

构建 Claws Mail SDK 并按上述方式设置 PKG_CONFIG_PATH，然后运行相同的 meson setup / meson compile / meson test 命令。插件将构建在 build/mcp.dll。

插件版本

编译进二进制文件的版本（由 plugin_version 和 status 工具返回）来自 -Dplugin_version，例如：

meson setup build -Dplugin_version=1.2.3

CI 会在发行版构建中使用推送的 git 标签设置该版本。若未设置，则构建会回退到 git describe，再回退到 0.0.0-dev。

安装

meson install -C build

这会将插件安装到 pkg-config --variable=plugindir claws-mail 报告的 Claws Mail 插件目录中。在配置 > 插件 > 加载...中，从该目录加载一次。

---

支持的 Claws Mail 版本

每个发行版都包含适用于 ci/claws-versions.json 中列出的每个 Claws Mail 版本的 Linux 和 Windows 构建。

---

许可证

GPL-3.0-or-later，详见 LICENSE。