Outlook MCP 服务器

一个提供 Microsoft Outlook 邮件功能访问的 Model Context Protocol (MCP) 服务器，允许大语言模型和其他 MCP 客户端通过标准化接口读取、搜索和管理邮件。

功能

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

先决条件

• 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"
      ]
    }
  }
}

可用工具

该服务器提供以下工具及其详细功能：

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：

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

6. reply_to_email_by_number：

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

7. compose_email：

   • 创建并发送新邮件
   • 支持 recipient、主题和正文内容
   • 可选 CC 字段用于添加更多 recipients
   • 通过 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 的内置搜索功能
• 仅支持基本邮件功能（无日历、联系人等）