Outlook MCP Server

🤖 Outlook MCP Server

Microsoft Outlook 的 AI 驱动邮件管理工具 —— 通过自然语言命令搜索、撰写、整理和批量转发邮件。

🤔 项目选择：本地方案还是云端方案

本项目使用 win32COM，完全在本地处理 Outlook 数据（更安全）；而我们的新版 Microsoft Graph MCP Server 可在线访问完整的 Microsoft 365 生态系统（功能更多）。请根据你的安全性和功能需求选择。

为什么选择本项目（win32COM）？

• ✅ 本地数据处理：所有邮件操作都在你的电脑上本地完成——数据不会离开你的设备
• ✅ 增强安全性：无需云端身份验证或 API 令牌——可使用你现有的 Outlook 设置
• ✅ 离线能力：即使没有互联网连接，也能访问和管理邮件
• ✅ 隐私优先：你的邮件数据绝不会接触外部服务器或云服务

为什么切换到 Microsoft Graph API？

• ✅ 完整的 Microsoft 365 生态系统：可访问 Mail、Calendar、Teams、OneDrive、SharePoint
• ✅ 跨平台支持：适用于 Windows、macOS、Linux 和移动设备
• ✅ 现代身份验证：使用设备代码流的 OAuth 2.0
• ✅ 云端规模的性能：无需依赖本地应用程序
• ✅ 在线访问：直接使用基于云的 Microsoft 365 服务

---

🚀 快速开始（2 分钟）

你将获得

• 智能邮件搜索：“查找上周有关预算审批的邮件”
• AI 邮件撰写：根据上下文建议起草回复
• 轻松整理：通过简单命令创建文件夹并移动邮件
• 批量转发：几分钟内将邮件发送给数百名收件人，而不是花上数小时

🤖 AI 行为与工作流

agent_prompt_template.md 定义了 AI 助手管理邮件时的行为：

• 目的：指导 AI 执行邮件搜索、摘要和起草工作流
• 关键规则：搜索采用 AND 逻辑、每次显示 5 封邮件、发送前先确认
• 安全性：内置限制确保用户掌控操作并防止未经授权的操作
• 使用方法：复制模板内容，并用它配置你的 AI 助手

请参阅模板，了解完整的行为准则和工作流定义

为什么选择 Outlook MCP Server？

功能	Outlook MCP Server	传统 Outlook	Outlook 加载项
AI 邮件搜索	✅ “查找老板发来的紧急邮件”	❌ 手动浏览文件夹	⚠️ 仅支持基本搜索
自然语言	✅ “显示上周的预算邮件”	❌ 需要复杂筛选条件	⚠️ 关键词支持有限
批量转发 100 封以上邮件	✅ 使用 CSV，仅需 2 分钟	❌ 手动操作需 50 分钟以上	⚠️ 需 20 分钟以上
AI 邮件撰写	✅ 根据上下文回复	❌ 手动撰写	⚠️ 基本模板
设置时间	✅ 2 分钟	✅ 已安装	❌ 10–30 分钟
隐私	✅ 100% 本地处理	✅ 仅本地处理	⚠️ 依赖云端
费用	✅ 完全免费	✅ 已包含	💰 5–50 美元/月
学习曲线	✅ 自然语言	✅ 熟悉的界面	⚠️ 全新界面

真实场景中的影响

之前：“我需要把这封邮件转发给 150 位团队成员……”

• 手动操作：点击“转发” → 输入每个邮箱 → 发送 → 浪费 2 小时以上
• 传统 Outlook：创建通讯组列表 → 添加成员 → 转发 → 耗时 30 分钟以上

之后：“把这封邮件转发给 team.csv 中的所有人”

• Outlook MCP Server：加载 CSV → AI 转发给所有人 → 总共只需 2 分钟
• 节省时间：每批操作节省 48 分钟以上！

要求

• ✅ Python 3.8+
• ✅ Microsoft Outlook 2016+（必须正在运行）
• ✅ Windows 10+

安装与设置

方法 1：UVX（推荐 — 自动安装依赖项）

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["--with", "pywin32>=226", "--with-editable", ".", "outlook-mcp-server"]
    }
  }
}

方法 2：标准 Python

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt
python -m outlook_mcp_server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["-m", "outlook_mcp_server"]
    }
  }
}

方法 3：直接使用源代码（开发）

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"]
    }
  }
}

测试设置 ✅

向 AI 助手询问：“显示我最近的邮件”——如果能正常使用，就说明已准备就绪！

配置故障排除 🛠️

常见问题与解决方案：

问题	检查项	解决方案
“找不到 uvx”	是否已安装 UV？	运行 pip install uv，然后重试
“找不到 python”	Python 是否在 PATH 中？	使用完整路径，例如 C:\Python39\python.exe
“Outlook 未运行”	Outlook 窗口是否已打开？	先启动 Outlook，然后重启 MCP
“权限被拒绝”	是否拥有管理员权限？	以管理员身份运行终端
“找不到模块”	是否已安装依赖项？	运行 pip install -r requirements.txt

配置验证：

# Test your setup before connecting to AI
python -c "import outlook_mcp_server; print('✅ Server module loaded')"

# Test Outlook connection (Windows only)
python -c "import win32com.client; outlook = win32com.client.Dispatch('Outlook.Application'); print('✅ Outlook connected')"

针对不同 MCP 客户端的设置：

Claude Desktop：

1. 打开 Claude Desktop 设置
2. 找到“MCP Servers”部分
3. 点击“Add Server” → “Custom”
4. 粘贴 JSON 配置
5. 重启 Claude Desktop

其他 MCP 客户端：

• 查找“MCP Configuration”或“Server Settings”
• 将 JSON 添加到客户端的配置文件中
• 通常位于：~/.config/[client]/mcp.json

仍然无法解决？ 请附上错误消息和设置信息报告问题。

🎯 核心功能

邮件管理

• 搜索：按主题、发件人、内容或日期范围查找邮件
• 撰写：在 AI 辅助下撰写新邮件
• 回复：理解对话上下文的智能回复
• 批量转发：通过 CSV 文件向数百位收件人发送邮件（节省数小时！）

文件夹管理

• 列出：查看所有 Outlook 文件夹
• 创建：通过简单命令创建新文件夹
• 移动：在文件夹之间整理邮件
• 删除：移除文件夹（请谨慎——此操作不可撤销！）

📧 批量转发：节省邮件群发时间

真实场景用例

🎯 团队动态

• 将每周报告转发给整个团队
• 向所有团队成员发送重要动态
• 向利益相关者分发项目进展

📊 营销活动

• 向订阅者列表发送新闻简报
• 向客户群体转发促销邮件
• 向联系人群组发送活动邀请

🏢 企业沟通

• 向所有员工发送政策更新
• 向各部门转发培训材料
• 向公司通讯组列表分发公告

🔄 工作原理

简单工作流

1. 加载邮件：“显示最近的邮件” → 邮件显示在缓存中
2. 浏览结果：每页查看 5 封邮件，格式清晰
3. 执行操作：回复、移动、删除或获取 AI 摘要
4. 发送前确认：AI 始终会在发送邮件前询问

AI 助手的行为

• 理解自然语言：“查找老板发来的紧急邮件”
• 显示邮件摘要：单行概述 + 关键行动事项
• 根据上下文起草：回复时会理解对话内容
• 未经许可绝不发送：发送前始终会确认

批量转发工作流

1. 准备 CSV 文件

email
[email protected]
[email protected]
[email protected]

2. 使用自然语言

"Forward this email to everyone in my contacts.csv"
"Send this project update to my team list"
"Distribute this newsletter to subscribers.csv"

3. 其余工作交给 AI 处理

• 自动拆分较长的列表（每批最多 500 位收件人）
• 通过 BCC 发送，保护收件人隐私
• 在原始邮件前添加自定义消息
• 提供送达确认

节省时间

手动转发：100 封邮件 × 30 秒 = 50 分钟 批量转发：设置 30 秒 + 处理 2 分钟 = 2.5 分钟 节省时间：每批可节省 47.5 分钟！

🔧 常用命令

可以与 AI 助手一起尝试：

"Show me emails from last 3 days"
"Find emails about project updates" 
"Draft a reply to John about rescheduling"
"Create a folder called 'Work Projects'"
"Move email #3 to the Archive folder"

🛠️ 核心工具

搜索和加载邮件

• list_recent_emails_tool(days=7) - 加载近期邮件（最多 30 天）
• search_email_by_subject_tool("search term") - 搜索邮件主题
• search_email_by_sender_name_tool("sender name") - 按发件人搜索
• search_email_by_body_tool("search term") - 搜索邮件内容（速度较慢）

邮件操作

• view_email_cache_tool(page=1) - 浏览已加载的邮件（每页 5 封）
• get_email_by_number_tool(email_number) - 获取完整的邮件详情
• reply_to_email_by_number_tool(email_number, "reply text") - 回复邮件
• compose_email_tool("[email protected]", "subject", "body") - 发送新邮件

文件夹操作

• get_folder_list_tool() - 务必先使用，查看可用文件夹
• create_folder_tool("folder name") - 创建新文件夹
• move_email_tool(email_number, "target folder") - 在文件夹之间移动邮件
• move_folder_tool("source", "target") - 移动文件夹

安全提示

• 移动或删除前，务必先检查文件夹列表
• 邮件会缓存 - 使用缓存中的编号进行操作
• 未经确认绝不发送 - AI 总会在发送前征求确认

⚡ 性能

• 约 2 秒即可加载 100 封邮件
• 搜索实时完成
• 所有处理均在本地进行（您的数据会保留在本地）

✅ 质量与可靠性

完善的验证系统

• 输入验证：处理前验证所有用户输入
• 自定义错误消息：针对常见问题提供清晰且可执行的错误消息
• 安全检查：在无效操作引发问题前予以拦截

全面的测试

• 145+ 个单元测试：全面测试每项功能
• 配置覆盖：验证所有设置和常量
• 边缘情况处理：针对异常输入和场景进行测试
• 持续保障质量：每次更改都会运行测试，确保可靠性

这对您意味着什么

• 错误更少：验证会在错误引发问题前将其捕获
• 更好的错误消息：明确了解出了什么问题以及如何修复
• 可靠运行：全面测试确保性能稳定
• 安全操作：内置防护措施可防止意外丢失数据

🛡️ 隐私与安全

• 100% 本地处理：数据不会离开您的计算机
• 无云服务：完全离线运行
• 安全设计：使用您现有的 Outlook 安装

📚 需要帮助？

• 查看 Agent 提示词模板，了解 AI 助手的设置方法
• 查看 配置示例，了解不同的安装方法
• 阅读 Win32COM 与 Graph API 对比，了解技术详情
• 查看 Win32COM API 实现指南，了解性能优化
• 在 GitHub 仓库报告问题

---