Email Manager

🚀 ClaudePost 中文版

ClaudePost 是一款模型上下文协议（MCP）服务器，借助与 Claude 的自然语言对话，为用户提供无缝的电子邮件管理界面。用户可直接通过自然语言与 Claude 对话来处理电子邮件，支持搜索、阅读和安全发送等功能。

🚀 快速开始

ClaudePost 能让你通过自然语言与 Claude 交互，轻松管理电子邮件。要使用该项目，需满足以下先决条件：

• Python 3.12 或更高版本
• Gmail 账户（或其他邮件服务提供商）
• 若使用 Gmail：
  • 已启用两步验证
  • 已生成应用程序特定密码
• Claude 桌面应用程序

✨ 主要特性

电子邮件搜索与阅读

• 📧 可按日期范围和关键词搜索电子邮件。
• 📅 能查看每日电子邮件统计信息。
• 📝 支持阅读完整的电子邮件内容，包含邮件线程。

电子邮件撰写与发送

• ✉️ 支持抄送（CC）的电子邮件发送。
• 🔒 使用 TLS 进行安全电子邮件处理。

📦 安装指南

1. 安装 uv

# MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装完成后请重启终端

2. 克隆并设置项目

# 克隆仓库
git clone https://github.com/ZilongXue/claude-post.git
cd claude-post

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # Windows系统请使用：.venv\Scripts\activate

# 安装依赖项
uv pip install -e .

3. 创建 .env 文件

在项目根目录下创建 .env 文件，并按如下示例填写：

EMAIL_ADDRESS=your.email@gmail.com
EMAIL_PASSWORD=your-app-specific-password
IMAP_SERVER=imap.gmail.com
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587

4. 配置 Claude 桌面

• 打开 Claude Desktop 的设置界面。
• 在插件或扩展部分启用或配置 ClaudePost 相关选项。
• 确保将项目路径正确添加到 Claude 的环境变量中，例如：

/your/project/path/claude-post

💻 使用示例

基础用法

搜索邮件

查一下我今天早上收到的邮件是什么内容。

发送邮件

给张三发一封邮件，主题是项目进度报告，内容写最近项目的进展顺利，请他注意相关细节。

📚 详细文档

项目结构

ClaudePost/
├── email_client.py          # 邮件处理逻辑
├── config.py                # 配置参数设置
└── log/                    # 日志记录文件夹
└── email_client.log     # 应用日志文件

服务器运行

• 使用 Claude 启动服务器，确保网络连接正常。
• 在 Claude 中使用自然语言命令与电子邮件进行交互，如发送邮件或管理收件箱。

🔧 技术细节

日志记录

应用程序将详细信息记录到 email_client.log 文件。查看该文件以获取调试信息和错误消息。

安全提示

• 使用应用特定密码代替个人账户密码。
• 对于 Gmail 用户：
  1. 启用两步验证。
  2. 生成应用程序密码。
  3. 在 .env 文件中使用此密码。

📄 许可证

本项目在 MIT 许可证下发布，具体见 LICENSE 文件。