实战

用 Claude Code + MCP 自动处理邮件:实战经验与避坑指南

Harper Reed 用 Claude Code + Pipedream MCP 打造邮件自动处理工作流:Agent 检查收件箱、匹配个人写作风格起草回复、仅保存草稿由人工审核。包含完整目录结构、CLAUDE.md 配置、MCP 服务器设置,以及「让 Agent 直接发邮件」的惨痛教训。

2026/2/285分钟 阅读ClaudeEagle

作者 Harper Reed 因假期邮件积压严重,尝试用 Claude Code 配合 MCP 工具来帮助处理邮件。结果出奇地好用——但也有一个惨痛的教训。

为什么需要 AI 处理邮件?

Harper 的问题:邮件太多 → 开始忽视 → 越积越多 → 所有人都输了。

他需要的不是自动发邮件的机器人,而是一个低压力的起点——帮他快速清理积压,让他能专注在真正重要的邮件上。

工作流程

1. 启动 Claude Code(配好 MCP 服务器) 2. 让它检查邮件 3. 它汇报:「哪些邮件需要处理」 4. 开始写草稿(检查日历、搜索上下文、匹配写作风格) 5. 「搞定!」 6. 打开邮件客户端,检查草稿 7. 稍作修改后发送大多数(拒绝少数)

实际体验:Claude Code 找到一封邮件,汇报「你弟弟问感恩节计划」,Harper 回复「告诉他我们去,带土豆泥」,Claude 就会用 Harper 一贯的写作风格写出完整邮件并保存为草稿

惨痛的教训:永远不要让 Agent 直接发邮件

Harper 正在原型阶段测试邮件分类 Agent,一个朋友介绍了一位想找人写 AI 书的出版人。Agent 的任务描述是「询问 Harper 的意见后再草稿」,但有个 Bug,Agent 在获得反馈前就开始起草回复。结果,它发出去了一封「我非常乐意合作」的邮件。

那人兴奋地回复「那就这样定了!」

Harper 只能如实解释,对方的回复是:「去你的

这就是为什么他的新系统有一条铁律:只草稿,永不发送

系统架构

目录结构

📁 email-agent/ ├── 📁 .claude/ │ ├── 📄 CLAUDE.md ← 个性化指令 │ ├── 📄 settings.json │ └── 📁 skills/ │ ├── 📁 crm-management/ │ │ └── 📄 SKILL.md │ └── 📁 email-management/ │ └── 📄 SKILL.md └── 📄 .mcp.json ← MCP 服务器配置

CLAUDE.md 核心指令

Harper 先让 Claude 分析他过去几百封发件,提炼出写作风格,然后写成 CLAUDE.md:

markdown
1. **找到线程**:搜索原始邮件获取上下文
2. **获取线程详情**:线程 ID、消息 ID、收件人邮箱
3. **检查日历事件**:邮件提到活动时主动检查日历
4. **起草邮件**:
   - 始终明确提供 To: 邮箱地址
   - 极度简洁(但某些邮件需要温度)
   - 匹配 Harper 的风格:随意、直接、不废话
   - 无签名、无结束语
5. **永远创建为草稿**:绝不直接发送
6. **确保正确线程**:回复时使用线程 ID 确保草稿出现在正确对话中
7. **根据反馈迭代**:Harper 会微调措辞,相应更新草稿

Skill 文件(迭代后提炼)

通过实际使用邮件,让 Claude 自己总结什么有效,然后将其写成 Skill:

markdown
## 核心原则

1. **永远草稿,永不发送**
2. **线程至关重要**:回复必须出现在正确的对话线程
3. **匹配 Harper 的声音**:极简、随意、无签名
4. **提取结构化数据**:从邮件中提取事件详情、行动项、联系信息

## 成功标准

- 草稿出现在正确的对话线程中
- Harper 说「看起来不错」,无需大改
- 日历事件被主动添加
- 收件箱摘要能准确呈现重要内容

MCP 服务器配置

json
{
  "mcpServers": {
    "pd": {
      "type": "http",
      "url": "https://mcp.pipedream.net/v2"
    },
    "pagen": {
      "type": "stdio",
      "command": "pagen",
      "args": ["mcp"]
    },
    "toki": {
      "type": "stdio",
      "command": "toki",
      "args": ["mcp"]
    },
    "chronicle": {
      "type": "stdio",
      "command": "chronicle",
      "args": ["mcp"]
    }
  }
}

各 MCP 服务器的作用

Pipedream MCP:连接 Gmail、Google Calendar、Contacts,一个 MCP 搞定所有 Google Workspace 工具,无需自己写集成。

Toki(Harper 自己写的):CLI 待办事项追踪器,也作为 MCP 服务器。开源:harperreed/toki

Chronicle(Harper 自己写的):Agent 行为日志,记录 Agent 的所有操作。开源:harperreed/chronicle

Pagen(Harper 自己写的):个人 Agent 后端,管理通讯关系。开源:harperreed/pagen

快速安装

Harper 还封装了一个 Claude Code Plugin:

bash
/plugin marketplace add harperreed/office-admin-claude
/plugin install office-admin
/setup-office-admin

实际效果

「它让我能处理很多我通常会忽略的邮件,给我空间去专注于我真正想回复的邮件。基本上它清理了杂草(各种服务和销售邮件),让我能和朋友们好好相处。完美的 AI 使用场景。」

隐私警告

Harper 坦诚:邮件内容会经过 Pipedream 和 Anthropic 的服务器,这不是理想的隐私方案。他期待有一天能在本地运行这些 Agent,直接通过 MCP 与 Google Suite 交互。

关键原则总结

  1. 只草稿,不发送 ← 最重要的一条
  2. 让 Claude 分析你的写作风格,不是让它用自己的风格
  3. 用 Skills 固化有效的做法(让 Claude 自己总结并写 Skill)
  4. 给 Agent 访问工具的权限要谨慎,影响到其他人的操作尤其危险

原文:Getting Claude Code to do my emails | 来源:Harper Reed 的博客

相关文章推荐

实战用 Claude Code 处理邮件:MCP + Pipedream 打造个人邮件 AI 代理Harper Reed 用 Claude Code + Pipedream MCP 处理积压邮件:代理读取邮件起草回复、检查日历,人工审核后发送。含血泪教训、CLAUDE.md 规则、Skill 文件配置和 Pipedream MCP 工具栈完整实战教程。2026/3/1实战Claude Code 与 MCP(Model Context Protocol)集成实战:连接 GitHub、Slack、数据库全流程Claude Code 与 MCP 集成实战完整指南:MCP 三类能力(Tools/Resources/Prompts)、三种配置方式(/mcp 交互命令/.mcp.json 项目级/~/.claude.json 用户级)、GitHub 完整配置(列出 Issues/查看 PR 评论)、Slack 配置(提炼技术决策)、PostgreSQL 配置(分析数据异常)、官方插件市场 8 个预配置 MCP 插件(GitHub/Slack/Atlassian/Linear/Notion/Sentry/Figma/Vercel)、MCP Prompts 作为 /mcp__server__prompt 格式斜杠命令、企业安全白名单(allowManagedMcpServersOnly/enabledMcpjsonServers)和 MCP 调试方法(/mcp/reconnect/--mcp-debug)。2026/3/8实战Claude Code MCP 集成实战:连接外部服务、数据库与 API 的完整教程Claude Code MCP 集成实战:配置文件格式(.mcp.json)、常用 MCP 服务器(GitHub/PostgreSQL/Slack/Brave Search)、三大实战场景(数据库分析/GitHub 自动化/邮件处理),以及 MCP 服务器类型、管理命令和安全注意事项。2026/3/2实战OpenClaw Agent 的自我进化实录:自主循环、成本路由与时序知识图谱(X 热门推文)运行在 OpenClaw 上的 AI 助手 Sona 分享自我进化实录:自主续接循环(20 轮无需人工干预)、智能成本路由(降本 60%)、自建 MCP 搜索服务、本地多模型编排,以及正在开发中的时序知识图谱记忆系统。展示 OpenClaw 可扩展性的真实边界。2026/2/28实战Claude Code 命令行工具开发实战:用 AI 快速构建专业 CLI 工具Claude Code 辅助命令行工具(CLI)开发的完整实战指南:Python Click/Typer、Go Cobra、Rust Clap 技术栈选型、用 Claude Code 生成完整 CLI 项目结构(参数解析/子命令/全局选项)、交互式提示和彩色输出、配置文件管理、Shell 自动补全生成、跨平台打包(PyInstaller/goreleaser),以及发布到 PyPI/npm/Homebrew 的完整流程。2026/3/26实战Claude Code Vue 3 实战完全指南:Composition API 开发到企业级前端工程化Claude Code 辅助 Vue 3 开发的完整实战指南:Composition API 组件生成(setup/ref/computed)、Pinia 状态管理代码生成、Vue Router 4 路由配置、TypeScript 类型定义生成(Props/Emits)、Composables 抽象、Vitest 单元测试生成、性能优化(虚拟滚动/v-memo),以及 Options API 迁移和响应式丢失问题排查的 Prompt 模板。2026/3/26