lessie-email

Lessie Email — 多提供商邮件管理

设置

将 Lessie Email MCP 服务添加到 MCP 配置中（Claude Code ~/.claude.json、Cursor ~/.cursor/mcp.json、Codex ~/.codex/config.toml 等）：

{
  "mcpServers": {
    "lessie-email-mcp": {
      "command": "npx",
      "args": ["-y", "@lessie/mcp-server"],
      "env": {
        "LESSIE_REMOTE_MCP_URL": "https://app.lessie.ai/email-api/mcp-public/mcp"
      }
    }
  }
}

卸载

从 MCP 配置中移除 "lessie-email" 条目，然后运行 rm -rf ~/.lessie/。

版本检查

在每次会话开始时运行一次此检查。检查不会阻塞操作——如果任何命令失败，请静默跳过。

1. 从此文件上方的元数据 version 字段读取当前本地版本。
2. 获取远程版本：

   curl -sf --max-time 5 https://raw.githubusercontent.com/LessieAI/lessie-skill/main/lessie-email/SKILL.md | head -5 | grep 'version:' | head -1 | awk '{print $2}'
   

3. 如果远程版本更新 → 告知用户：

   ⬆️ 有更新版本的 lessie-email skill 可用（{current} → {remote}）。运行以下命令进行更新：

   npx skills add LessieAI/lessie-skill -y -g
   

4. 如果版本一致或检查失败 → 跳过，不作提示。

授权

1. 直接调用 use_lessie 执行所需操作——如果已连接，则跳过授权。
2. 如果 use_lessie 失败（例如，返回“not authorized”或“remote MCP server not connected”）→ 调用 authorize 启动 OAuth 流程：
   • authorize 会返回授权 URL。告知用户需要打开浏览器登录或注册 Lessie，并使用适当的系统命令打开该 URL：
     • macOS：open "<url>"
     • Linux：xdg-open "<url>"
     • Windows：start "<url>"
   • 告知用户浏览器已打开，需要完成登录或注册。
   • 用户确认后，再次调用 authorize 验证连接。
   • 如果授权失败（超时、拒绝、端口冲突），请按照 authorize 返回的诊断提示操作并重试。
3. 授权成功后 → 重试原来的 use_lessie 调用。

故障排除：授权反复失败

根本原因：旧会话遗留的 lessie-mcp-server 进程占用了回调端口（19836），导致端口回退并破坏 OAuth 客户端状态。

修复方法——终止遗留进程并清除存储，然后重新授权：

ps aux | grep 'lessie-mcp-server' | grep -v grep | awk '{print $2}' | xargs kill 2>/dev/null
rm -rf ~/.lessie/
lsof -i :19836 | grep LISTEN  # should return nothing

打开浏览器前务必告知用户——切勿静默重定向。

快速开始

设置完成后，试试：

• “显示我的邮件账户及未读数量”
• “从 [email protected] 向 [email protected] 发送一封关于 Q2 报告的邮件”
• “列出我最近的邮件会话”
• “向这 50 位联系人创建一场群发邮件活动”
• “给工程团队起草一封关于迭代评审的邮件”
• “将此会话中的所有邮件标记为已读”

工具概览

邮件账户

工具	使用场景
list_email_accounts_with_unread	查看所有已关联的邮件账户及未读数量

邮件操作

工具	使用场景
send_email	发送邮件（支持 HTML、抄送/密送、附件和回复）
get_email_detail	查看完整邮件详情（内容、投递状态、阅读状态）
list_sent_emails	使用游标分页浏览已发送邮件
get_email_quota	查看指定邮箱地址的每日发送配额
delete_email	软删除邮件
set_email_read_status	将邮件标记为已读或未读

会话管理

工具	使用场景
list_threads	浏览邮件对话（可按全部/已读/未读筛选）
get_thread_messages	查看某个邮件会话中的所有邮件
delete_thread	软删除整个邮件会话
set_thread_read_status	将会话中的所有邮件标记为已读或未读

草稿

工具	使用场景
create_draft	创建新的邮件草稿
update_draft	更新现有草稿（主题、内容、收件人等）
delete_draft	删除草稿
list_drafts	使用游标分页浏览草稿

批量邮件任务

工具	适用场景
create_task	创建批量邮件发送任务（自动为每位收件人安排发送时间）
list_tasks	查看批量任务及其进度信息
get_task_detail	查看任务详情，包括每位收件人的送达、打开和失败统计
delete_task	删除批量邮件任务
pause_task	暂停正在运行的批量邮件任务
resume_task	恢复已暂停的批量邮件任务

Agent 行为规则

发送邮件前

1. 务必先检查账户：调用 list_email_accounts_with_unread 获取可用的发件人地址。
2. 未绑定邮件账户：如果账户列表为空，告知用户尚未关联任何邮件账户，并引导他们访问 https://app.lessie.ai/ 绑定邮件账户。使用相应的系统命令打开 URL：
   • macOS：open "https://app.lessie.ai/"
   • Linux：xdg-open "https://app.lessie.ai/"
   • Windows：start "https://app.lessie.ai/" 然后请用户绑定后返回并重试。
3. 务必检查配额：针对选定的发件人调用 get_email_quota，确认配额充足。
4. 切勿猜测邮件地址：只能使用账户列表返回的地址。

回复邮件

1. 获取邮件会话上下文：调用 get_thread_messages 查看对话内容。
2. 使用最后一封邮件中的 thread_id 和 reply_to_message_id。
3. 调用 send_email 时传入这两个参数，以正确地在原邮件会话中回复。

草稿工作流

1. 使用 create_draft 创建草稿，并指定发件人、收件人、主题和内容。
2. 如需修改，使用 update_draft 更新草稿。
3. 准备就绪后，使用 send_email 发送最终内容（草稿不会直接发送）。
4. 发送后或不再需要时，使用 delete_draft 删除草稿。

批量任务管理

• 使用 create_task 创建任务后，通过 get_task_detail 监控进度。
• 使用 pause_task 暂时停止正在运行的营销活动（例如发现问题时）。
• 使用 resume_task 继续已暂停的营销活动。
• 使用 delete_task 永久删除任务。

Gmail/Outlook 专属说明

• 对于 Gmail/Outlook 账户，调用 get_email_detail、delete_email、get_thread_messages 时，务必传入 email 参数。
• 系统会根据邮件地址自动路由到正确的服务提供商 API。

关键限制

• 游标分页：所有列表端点都使用 cursor + size，请传入上一次响应中的 next_cursor。
• 默认页面大小：20（最大 100）。
• 邮件内容：至少提供 text_content 或 html_content；如果只提供文本，系统会自动生成 HTML。
• 附件必须使用预先上传的 S3 键，并提供 s3key、filename、mime_type、size。
• 批量任务会自动安排发送时间，以遵守配额限制并避免垃圾邮件。