Lettio MCP

Lettio MCP

让 AI 助手从私有的、托管于欧盟的邮箱中读取、搜索和发送邮件。

Lettio MCP 是一个 Model Context Protocol 服务，可通过 JMAP 将 AI Agent（Claude、Cursor 以及任何其他 MCP 客户端）连接到 Lettio 邮箱。助手可以整理收件箱、查找邮件并发送回复，而且你的邮件绝不会离开欧洲。

• 🇪🇺 默认面向欧洲 — 直接连接你自己的欧盟托管邮箱，没有第三方中间商。
• 🔒 安全发送 — 服务只能以当前登录的邮箱身份发送邮件。它无法被诱骗为其他地址发送邮件。
• 📬 Agent 所需的一切 — 基于开放的 JMAP 标准，支持列出、搜索、读取和发送邮件。
• 👥 一个或多个邮箱 — 可配置单个或多个账户。

不想安装任何东西？Lettio 也提供一个托管且受 OAuth 保护的 MCP 服务，地址为 https://mcp.lettio.eu/mcp — 在客户端中添加该 URL 并登录即可。此 npm 包是供希望在自己的机器上运行的用户使用的本地／可自托管选项。

工具

工具	功能
list_accounts	列出此服务配置的邮箱。
list_mailboxes	列出账户中的文件夹，以及邮件数和未读邮件数。
list_recent_emails	列出邮箱中的最新邮件（默认为收件箱）。
search_emails	根据发件人、主题和正文进行全文搜索。
read_email	根据邮件 ID 读取一封邮件的完整内容。
send_email	以当前登录的邮箱身份发送纯文本邮件。
reply_email	在原邮件会话中回复（保留对话），也可选择回复所有人。
set_read_status	将邮件标记为已读或未读。
flag_email	为邮件加旗标（星标）或取消旗标。
move_email	将邮件移至文件夹 — archive、trash（可撤销）或指定文件夹名称。

要求

• Node.js 18 或更高版本。
• 一个 Lettio 邮箱及其应用密码（请使用专用应用密码，而不是主登录密码）。

与 Claude Desktop 搭配使用

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "lettio": {
      "command": "npx",
      "args": ["-y", "@lettio/mcp"],
      "env": {
        "LETTIO_USERNAME": "[email protected]",
        "LETTIO_PASSWORD": "your-app-password"
      }
    }
  }
}

重启 Claude Desktop；Lettio 工具就会显示在工具菜单中。

配置

完全通过环境变量进行配置。

单个邮箱

变量	必填	说明
LETTIO_USERNAME	是	完整电子邮件地址，例如 [email protected]。
LETTIO_PASSWORD	是	邮箱的应用密码。
LETTIO_HOST	否	邮件主机。默认为 https://mail.lettio.eu。
LETTIO_ACCOUNT_NAME	否	账户的易读名称（默认：用户名）。

多个邮箱

将 LETTIO_ACCOUNTS 设置为 JSON 数组，并省略单账户变量：

[
  { "name": "work", "username": "[email protected]", "password": "app-password" },
  { "name": "sales", "username": "[email protected]", "password": "app-password" }
]

然后，在任意工具调用中传入 account: "work"，即可选择要使用的邮箱。

安全性

邮件发送经过刻意限制。发送前，服务会向邮件主机查询当前登录邮箱获准使用的身份，并要求其中一个身份与登录地址相符。From 标头和 SMTP 信封中的 MAIL FROM 都会固定为该地址。没有用于选择其他发件人的参数，因此 Agent 绝不会以外部或任意邮箱的身份发送邮件。凭据从环境中读取，仅保留在内存中，且绝不会写入日志。

从源代码运行

npm install
npm run build
[email protected] LETTIO_PASSWORD=app-password npm start

许可证

MIT © Valmia Solutions s.r.o.