Lessie Email 是一个多服务商邮件管理技能,通过 MCP(Model Context Protocol)接入,让 AI 助手能够发送、管理和自动化邮件。它支持 Gmail、Outlook 和官方邮箱(Official Email)等多种邮箱服务商,系统会根据邮箱地址自动路由到对应的服务商 API。
用途 该技能适用于需要在对话中直接操作邮件的场景,例如查看邮箱账户与未读数量、发送邮件、回复会话、管理草稿,以及创建批量邮件任务。
主要能力
- 邮箱账户:查看所有已绑定邮箱账户及其未读数量。
- 邮件操作:发送邮件(支持 HTML、抄送/密送、附件、回复)、查看邮件详情(内容、投递状态、已读状态)、浏览已发送邮件、查询每日发送配额、软删除邮件、设置已读/未读状态。
- 会话线程管理:浏览邮件会话(支持全部/已读/未读筛选)、查看会话内所有消息、软删除整个会话、将会话内所有邮件标记为已读或未读。
- 草稿:创建、更新、删除草稿,以及分页浏览草稿。
- 批量邮件任务:创建批量发送任务(自动为每个收件人安排发送时间)、浏览任务及进度、查看每个收件人的投递/打开/失败统计、删除任务、暂停运行中的任务、恢复已暂停的任务。
使用方式
- 安装:在 MCP 配置中添加 Lessie Email 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/。
- 版本检查:每个会话开始时运行一次,非阻塞,失败则静默跳过。从技能元数据读取本地版本,并通过以下命令获取远程版本: 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}' 若远程版本更新,提示用户运行:npx skills add LessieAI/lessie-skill -y -g
- 授权:直接调用 use_lessie 执行操作;若已连接则跳过授权。若失败(如返回 "not authorized" 或 "remote MCP server not connected"),调用 authorize 启动 OAuth 流程。authorize 返回授权 URL 后,需告知用户将打开浏览器进行 Lessie 登录/注册,并使用对应系统命令打开:macOS 用 open "<url>",Linux 用 xdg-open "<url>",Windows 用 start "<url>"。用户确认后再次调用 authorize 验证连接,成功后重试原 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 # 应无返回 始终在打开浏览器前告知用户,不得静默跳转。
快速上手示例
- "Show me my email accounts and unread counts"
- "Send an email from alice@company.com to bob@example.com about the Q2 report"
- "List my recent email threads"
- "Create a bulk email campaign to these 50 contacts"
- "Draft an email to the engineering team about the sprint review"
- "Mark all emails in this thread as read"
代理行为规则
- 发送邮件前:先调用 list_email_accounts_with_unread 获取可用发件地址;若账户列表为空,告知用户尚未绑定邮箱,并引导访问 https://app.lessie.ai/ 绑定(macOS 用 open,Linux 用 xdg-open,Windows 用 start),绑定后重试;调用 get_email_quota 确认配额充足;不得猜测邮箱地址,只能使用账户列表返回的地址。
- 回复邮件:调用 get_thread_messages 获取会话上下文,使用最后一条消息的 thread_id 和 reply_to_message_id,在调用 send_email 时传入两者以实现正确的会话回复。
- 草稿流程:用 create_draft 创建草稿(指定发件人、收件人、主题、内容);需要时用 update_draft 更新;准备好后用 send_email 发送最终内容(草稿不会直接发送);发送后或不再需要时用 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 参数。
关键约束
- 游标分页:所有列表接口使用 cursor + size,需传入上一次响应中的 next_cursor。
- 默认页大小:20(最大 100)。
- 邮件内容:至少提供 text_content 或 html_content;若只提供文本,HTML 会自动生成。
- 附件:需要预先上传的 S3 key,包含 s3key、filename、mime_type、size。
- 批量任务会自动跨时间安排发送,以遵守配额并避免垃圾邮件。
适用场景 适合在 AI 助手对话中完成日常邮件收发、会话管理、草稿整理和批量邮件营销等任务,尤其适合需要跨多个邮箱服务商统一操作的场景。
限制 使用前必须完成 MCP 配置和 OAuth 授权;发送邮件受每日配额限制;附件需预先上传至 S3;批量发送会自动调度以控制频率。