Outlook MCP Server Main

🤖 Outlook MCP服务器

基于人工智能的Microsoft Outlook电子邮件管理 -使用自然语言命令搜索、撰写、组织和批量转发电子邮件。

⭐ 这为你节省了时间？ 星我们 -只需2秒，即可帮助数千名Outlook用户找到这款AI电子邮件助手！ ⭐

  

🤔 项目选择：本地与云方法

此项目使用win32COM，它完全在本地与您的Outlook数据一起工作（更安全），而我们的新 Microsoft Graph MCP服务器 提供对完整Microsoft 365生态系统的在线访问（更多功能）。根据您的安全和功能需求进行选择。

为什么选择这个项目（win32COM）？

• ✅ 当地数据处理：所有电子邮件操作都在您的计算机上本地进行，没有数据离开您的计算机
• ✅ 增强的安全性：不需要云身份验证或API令牌-适用于现有的Outlook设置
• ✅ 离线能力：即使没有互联网连接，也可以访问和管理电子邮件
• ✅ 隐私第一：您的电子邮件数据永远不会接触到外部服务器或云服务

为什么要切换到Microsoft Graph API？

• ✅ 完整的Microsoft 365生态系统：访问邮件、日历、团队、OneDrive、SharePoint
• ✅ 与跨平台支持：适用于Windows、macOS、Linux和移动设备
• ✅ 现代身份验证：具有设备代码流的OAuth 2.0
• ✅ 云级性能：没有本地应用程序依赖关系
• ✅ 在线访问：直接与基于云的Microsoft 365服务配合使用

______________________________________________________________________

🚀 快速入门（2分钟）

你会得到什么

• 智能电子邮件搜索：“查找上周关于预算审批的电子邮件”
• AI电子邮件写作：起草答复，提出切合实际的建议
• 易于组织：使用简单的命令创建文件夹和移动电子邮件
• 批量转发：在几分钟内而不是几小时内向100个收件人发送电子邮件

🤖 人工智能行为与工作流程

这 agent_prompt_template.md 定义了AI助手在管理电子邮件时的行为方式：

• 目的：指导人工智能的电子邮件搜索、摘要和起草工作流程
• 关键规则：AND搜索逻辑，5-by-5电子邮件显示，发送前确认
• 安全：内置约束确保用户控制并防止未经授权的操作
• 如何使用：复制模板内容并使用它来配置您的AI助手

*请参阅 模板 获取完整的行为准则和工作流定义*

为什么选择Outlook MCP服务器？

现实世界影响

之前：“我需要将此电子邮件转发给150名团队成员…”

• 手动：单击“前进”→ 键入每封电子邮件→ Send → 浪费2+小时
• 传统Outlook：创建通讯组列表→ 添加成员→ 转发→ 30+分钟

之后：“将此电子邮件转发给team.csv中的每个人”

• Outlook MCP服务器：加载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"]
    }
  }
}

测试您的设置✅

问你的人工智能助手：“给我看看我最近的电子邮件”——如果它有效，你就准备好了！

配置故障排除🛠️

常见问题和解决方案：

配置验证：

# 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客户端特定设置：

克劳德桌面：

1. 打开克劳德桌面设置
2. 查找“MCP服务器”部分
3. 点击“添加服务器”→ “自定义”
4. 粘贴JSON配置
5. 重新启动克劳德桌面

其他MCP客户端：

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

仍然卡住？ 报告问题 包含错误消息和设置详细信息。

🎯 核心功能

电子邮件管理

• 搜索：按主题、发件人、内容或日期范围查找电子邮件
• 编排：在人工智能的帮助下撰写新电子邮件
• 回复：理解对话上下文的智能回复
• 批量转发：从CSV文件向100个收件人发送电子邮件（节省数小时！）

文件夹管理

• 列表：查看所有Outlook文件夹
• 创建：使用简单命令创建新文件夹
• 移动：在文件夹之间组织电子邮件
• 删除：删除文件夹（小心-这是永久性的！）

📧 批量转发：节省电子邮件分发时间

真实世界用例

🎯 团队更新

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

📊 营销活动

• 向订阅者列表发送新闻通讯
• 将促销电子邮件转发给客户群
• 向联系人组分发活动邀请

🏢 企业传播

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

🔄 运作原理

简单的工作流程

1. 加载电子邮件：“显示最近的电子邮件”→ 电子邮件出现在缓存中
2. 浏览结果：每页查看5封格式清晰的电子邮件
3. 采取行动：回复、移动、删除或获取AI摘要
4. 发送前确认：AI总是在发送电子邮件之前询问

AI助手行为

• 了解自然语言：“查找我老板的紧急电子邮件”
• 显示电子邮件摘要：一行概述+关键行动项目
• 带有上下文的草稿：回复理解对话
• 未经许可不得发送：发送前始终确认

批量转发工作流

1.准备CSV文件

email
john@company.com
jane@company.com
team@company.com

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("recipient@email.com", "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安装

📚 需要帮助？

• 检查 代理提示模板 用于AI助手设置
• 看 配置示例 适用于不同的安装方法
• 阅读 Win32COM与Graph API的比较 了解技术细节
• 审查 Win32COM API实施指南 用于性能优化
• 关于

______________________________________________________________________

⭐ 喜欢在电子邮件上节省时间吗？ 标记此回购 -帮助10000多名Outlook用户发现AI电子邮件管理！ ⭐

💡 快速星级提示：点击⭐ 上面的按钮-只需2秒，支持开源电子邮件AI！