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 文件。