Outlook MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，提供对Microsoft Outlook电子邮件功能的访问，允许大型语言模型（LLMs）和其他MCP客户端通过标准化接口读取、搜索和管理电子邮件。

功能

• 文件夹管理：列出Outlook客户端中的可用邮件文件夹
• 邮件列表：从指定时间段检索邮件
• 邮件搜索：按联系人名称、关键词或短语（使用OR运算符）搜索邮件
• 邮件详情：查看完整的邮件内容，包括附件
• 邮件撰写：创建并发送新邮件
• 邮件回复：回复现有邮件

先决条件

• Windows操作系统
• Python 3.10或更高版本
• 已安装并配置了有效账户的Microsoft Outlook
• Claude Desktop或其他兼容MCP的客户端

安装

1. 克隆或下载此仓库
2. 安装所需依赖项：

pip install mcp>=1.2.0 pywin32>=305

3. 配置Claude Desktop（或您首选的MCP客户端）以使用此服务器

配置

Claude Desktop配置

在您的MCP_client_config.json文件中添加以下内容：

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

使用方法

启动服务器

您可以直接启动服务器：

python outlook_mcp_server.py

或者让如Claude Desktop这样的MCP客户端通过配置来启动它。

可用工具

该服务器提供了以下工具：

1. list_folders：列出Outlook中所有可用的邮件文件夹
2. list_recent_emails：列出指定天数内的邮件标题
3. search_emails：按联系人名称或关键词搜索邮件
4. get_email_by_number：获取特定邮件的详细内容
5. reply_to_email_by_number：回复特定邮件
6. compose_email：创建并发送新邮件

示例工作流程

1. 使用list_folders查看所有可用的邮件文件夹
2. 使用list_recent_emails查看最近的邮件（例如，过去7天）
3. 使用search_emails通过关键词查找特定邮件
4. 使用get_email_by_number查看完整邮件
5. 使用reply_to_email_by_number回复邮件

示例

列出最近的邮件

你能给我展示过去3天内未读的邮件吗？

搜索邮件

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

查看邮件详情

显示列表中第2封邮件的详细信息

回复邮件

回复第3封邮件：“感谢提供的信息。我会审阅并在明天回复。”

撰写新邮件

给john.doe@example.com发送一封主题为“会议议程”的邮件，正文为“这是即将到来的会议议程...”

故障排除

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

安全注意事项

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

限制

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