Outlook MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 Microsoft Outlook 电子邮件功能的访问，允许 LLM 和其他 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 客户端以自动启动它。

将其添加到您的 MCP 客户端配置中：

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

      ]
    }
  }
}

可用工具

该服务器提供以下具有详细功能的工具：

1. list_folders:

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

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:

   • 创建并发送新电子邮件
   • 支持收件人、主题和正文内容
   • 可选的抄送字段用于其他收件人
   • 通过 Outlook 客户端处理电子邮件发送

示例工作流程

1. 使用 list_folders 查看所有可用的邮件文件夹
2. 使用 list_recent_emails 查看最近的电子邮件（例如，过去 7 天的电子邮件）
3. 使用 view_email_cache(page=1) 以 1 页为单位浏览匹配的电子邮件
4. 使用 get_email_by_number 查看完整的电子邮件
5. 使用 reply_to_email_by_number 回复电子邮件

例子

列出最近的电子邮件

你能给我展示一下最近 3 天内未读的邮件吗？

搜索电子邮件

搜索过去一周内关于“项目更新 OR 会议记录”的电子邮件

查看缓存的电子邮件

显示我的缓存电子邮件的第 2 页

阅读电子邮件详情

显示列表中电子邮件 #2 的详细信息

回复电子邮件

回复电子邮件 #3，内容为：“谢谢你的信息。我将审查此内容，并在明天回复您。”

撰写新电子邮件

发送一封电子邮件给 john.doe@example.com，主题为“会议议程”，正文为“这是我们即将举行的会议的议程……”

故障排除

• 连接问题: 确保 Outlook 正在运行并已正确配置
• 权限错误: 确保脚本有权访问 Outlook
• 搜索问题: 对于复杂的搜索，请尝试在术语之间使用 OR 运算符
• 电子邮件访问错误: 检查电子邮件 ID 是否有效且可访问
• 服务器崩溃: 检查 Outlook 的连接和稳定性

安全注意事项

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

局限性

• 目前仅支持文本电子邮件（不支持 HTML）
• 最长电子邮件历史记录限制为 30 天
• 搜索功能取决于 Outlook 的内置搜索功能
• 仅支持基本的电子邮件功能（无日历、联系人等）