Outlook MCP Server Main

🚀 Outlook MCP 服务器

Outlook MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务，它为大语言模型和其他 MCP 客户端提供了标准化接口，使其能够方便地访问 Microsoft Outlook 的邮件功能，实现邮件的读取、搜索与管理操作。

🚀 快速开始

要使用 Outlook MCP 服务器，你需要满足以下先决条件，并按照安装步骤进行操作：

先决条件

• 操作系统为 Windows。
• 安装 Python 3.11 或更高版本。
• 已安装 Microsoft Outlook 并配置了活跃账户。
• 准备好 Claude Desktop 或其他 MCP 兼容客户端。

安装步骤

1. 克隆或下载此仓库。
2. 安装所需的依赖项，在命令行中执行以下命令：

pip install mcp>=1.2.0 pywin32>=305

3. 配置 Claude Desktop（或其他 MCP 客户端）以自动启动该服务器。

客户端配置

将以下内容添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "outlook": {
      "isActive": true,
      "name": "outlook",
      "description": "Outlook 工具",
      "command": "python",
      "args": [
        "${workspaceFolder}/outlook_mcp_server.py"
      ]
    }
  }
}

✨ 主要特性

• 文件夹管理：可列出 Outlook 客户端中的所有可用邮件文件夹。
• 邮件列表：能从指定时间段内检索邮件。
• 邮件搜索：支持根据联系人姓名、关键词或短语（支持 OR 运算符）搜索邮件。
• 邮件详细信息：可查看完整的邮件内容，包括附件。
• 邮件编写：能够创建并发送新邮件。
• 邮件回复：可对现有的邮件进行回复。

💻 使用示例

基础用法

将配置信息添加到 MCP 客户端后，你就可以使用服务器提供的各种工具了。以下是各工具的详细介绍：

1. list_folders：

   • 列出 Outlook 中的所有可用邮件文件夹。
   • 显示文件夹层次结构，最多显示三级深度。
   • 返回格式化的文件夹和子文件夹列表。

2. list_recent_emails：

   • 列出指定天数（1 - 30）内的邮件标题。
   • 可以指定要搜索的文件夹（默认为收件箱）。
   • 缓存结果以便于详细查看。
   • 返回找到的邮件数量和查看它们的说明。

3. search_emails：

   • 根据联系人姓名或关键词搜索邮件。
   • 支持 OR 运算符用于多个搜索词。
   • 搜索主题、发件人名称和正文内容。
   • 返回匹配项的数量和查看它们的说明。

4. view_email_cache：

   • 浏览缓存邮件，每页显示 5 条。
   • 显示邮件主题、发件人、接收时间和已读状态。
   • 提供上一页/下一页导航。
   • 需要先使用 list_recent_emails 或 search_emails。

5. get_email_by_number：

   • 根据编号检索特定邮件的详细内容。
   • 显示完整的正文、收件人和附件。
   • 需要从缓存列表中提供邮件编号。
   • 提供回复邮件的选项。

6. reply_to_email_by_number：

   • 根据编号回复特定邮件。
   • 使用缓存列表中的邮件编号。
   • 发送带有指定正文内容的回复。
   • 维持原始邮件线程。
   • 可选：指定“收件人”和“抄送”字段的自定义收件人。
     • 默认行为是回复所有（发件人 + 抄送）。
     • 允许覆盖默认收件人如果需要。

7. compose_email：

   • 创建并发送新邮件。
   • 支持收件人、主题和正文内容。
   • 可选 CC 字段用于添加更多收件人。
   • 通过 Outlook 客户端处理邮件发送。

高级用法

示例工作流程

1. 使用 list_folders 查看所有可用的邮件文件夹。
2. 使用 list_recent_emails 查看最近的邮件（例如，过去 7 天内的）。
3. 使用 search_emails 根据关键词搜索邮件。
4. 使用 view_email_cache 浏览缓存的邮件。
5. 使用 get_email_by_number 查看特定邮件的详细信息。
6. 使用 reply_to_email_by_number 回复邮件。
7. 使用 compose_email 创建并发送新邮件。

⚠️ 重要提示

⚠️ 重要提示

此服务器可以访问你的 Outlook 邮件账户，并且可以读取、发送和管理邮件。仅在受信任的 MCP 客户端和安全环境中使用它。

🔧 技术细节

• 当前仅支持纯文本邮件（不支持 HTML）。
• 最大邮件历史限制为 30 天。
• 搜索功能依赖于 Outlook 的内置搜索功能。
• 仅支持基本邮件功能（无日历、联系人等）。