Outlook MCP Server

Outlook MCP 服务

一个模型上下文协议（MCP）服务，可访问 Microsoft Outlook 电子邮件功能，让大模型和其他 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 回复电子邮件

示例

列出近期邮件

Could you show me my unread emails from the last 3 days?

搜索电子邮件

Search for emails about "project update OR meeting notes" in the last week

阅读电子邮件详情

Show me the details of email #2 from the list

回复电子邮件

Reply to email #3 with: "Thanks for the information. I'll review this and get back to you tomorrow."

撰写新邮件

Send an email to [email protected] with subject "Meeting Agenda" and body "Here's the agenda for our upcoming meeting..."

故障排除

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

安全注意事项

此服务可以访问你的 Outlook 电子邮件帐户，并可读取、发送和管理电子邮件。请仅在安全环境中与可信的 MCP 客户端配合使用。

限制

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