Outlook MCP Server

什么是 Outlook MCP Server？

Outlook MCP Server 是一个面向 Windows 的社区版 outlook mcp server，可让 Claude 和其他 MCP 客户端通过本机安装的 Microsoft Outlook 列出、搜索、阅读、回复和发送邮件。

它是一个单文件 Python 脚本（outlook_mcp_server.py），基于 MCP Python SDK 的 FastMCP 和 pywin32 构建。它不调用云端 API，而是通过 COM/MAPI 驱动 Outlook 桌面应用，因此直接使用 Outlook 中已登录的账户。该项目由 Wallisking1991 在 GitHub 上维护，并非 Microsoft 官方产品。

如何使用 Outlook MCP Server？

前提条件

• Windows（服务器依赖 pywin32 和 Outlook COM 接口）
• Python 3.10 或更高版本
• 已安装 Microsoft Outlook 并配置了有效账户
• Claude Desktop 或其他兼容 MCP 的客户端

无需 API 密钥、OAuth 应用或 Microsoft Graph 注册，服务器直接使用你电脑上的 Outlook 配置文件。

安装

从 GitHub 克隆或下载仓库，然后安装依赖：

pip install mcp>=1.2.0 pywin32>=305

仓库的 requirements.txt 中也列出了这两个包。你可以手动启动服务器，确认它能连接到 Outlook：

python outlook_mcp_server.py

启动时它会连接 Outlook，打印收件箱中的邮件数量，然后启动 MCP 服务器。日常使用时，由 MCP 客户端负责启动即可。

Claude Desktop

将服务器添加到 Claude Desktop 的 MCP 配置中，并把路径替换为脚本在你电脑上的完整路径：

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

保存后重启 Claude Desktop。仓库附带的示例 claude_desktop_config.json 使用了 d:\\Cline\\MCP\\outlook_mcp_server.py 这样的 Windows 绝对路径。注意 JSON 中需要使用双反斜杠。

其他 MCP 客户端

服务器通过标准输入/输出（stdio）运行，因此任何能启动本地命令的客户端（Cursor、VS Code、Claude Code 等）都可以使用相同的 command 和 args。README 只记录了 Claude Desktop 的配置方式，其他客户端请按其自身文档注册本地 stdio 服务器。

Outlook MCP Server 的主要功能

• 文件夹管理：列出 Outlook 客户端中所有可用的邮件文件夹。
• 邮件列表：获取最近 1 到 30 天内的邮件标题，可来自收件箱或指定文件夹。
• 邮件搜索：按联系人姓名、关键词或短语搜索，支持在词之间使用 OR。
• 邮件详情：打开列表中某封邮件的完整内容，包括附件信息。
• 回复：按最近一次列表中的编号回复指定邮件。
• 撰写：创建并发送新邮件，可选抄送（CC）收件人。
• 无需云端凭据：通过本地 Outlook 桌面应用工作，无需配置 Microsoft Graph。

Outlook MCP Server 工具

README 中记录了六个工具，可分为三组。

浏览与搜索。 list_folders 返回邮箱中的文件夹。list_recent_emails 列出若干天内的邮件标题（默认 7 天，最多 30 天），并可指定文件夹名。search_emails 接受搜索词以及相同的 days 和文件夹选项，支持 project update OR meeting notes 这样的 OR 查询。

阅读。 get_email_by_number 根据邮件在最近一次 list_recent_emails 或 search_emails 结果中的编号，返回其完整内容。必须先列出或搜索邮件，否则该工具会返回错误。

写入。 reply_to_email_by_number 用你的文字回复指定编号的邮件。compose_email 接受收件人、主题、正文和可选的抄送地址，并会立即发送邮件，而不是保存为草稿。

典型流程依次为：list_folders，然后 list_recent_emails 或 search_emails，接着 get_email_by_number，最后 reply_to_email_by_number。

Outlook MCP Server 的使用场景

• 收件箱分拣："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"，然后让 Claude 总结内容或提取待办事项。
• 快速回复："Reply to email #3 with: "Thanks for the information. I'll review this and get back to you tomorrow.""
• 在对话中发信："Send an email to john.doe@example.com with subject "Meeting Agenda" and body "Here's the agenda for our upcoming meeting...""

Outlook MCP Server 与替代方案对比

这个 outlook mcp server 在本地运行，且仅支持 Windows。它通过 pywin32 控制桌面版 Outlook，因此无需注册 Microsoft 365 应用，但无法在 macOS、Linux 或远程主机上运行，并且只覆盖邮件功能。

基于 Microsoft Graph 的 Outlook MCP 服务器采用另一种方式：它们连接云端的 Microsoft 365 邮箱，通常还覆盖日历和联系人，代价是需要配置 OAuth 或应用。托管方案的一个例子是 Pipedream's Microsoft Outlook MCP。如果你的邮件在 Gmail 而非 Outlook，可以看看 Gmail MCP Server。

Outlook MCP Server 常见问题排查

• 连接问题：确认 Outlook 正在运行，且已配置有效账户。手动运行 python outlook_mcp_server.py 可以看出脚本能否访问你的收件箱。
• 权限错误：脚本需要访问 Outlook 的权限。请让 MCP 客户端与 Outlook 在同一个 Windows 用户下运行。
• "No emails have been listed yet"：get_email_by_number 和 reply_to_email_by_number 基于最近一次列表工作，请先运行 list_recent_emails 或 search_emails。
• 搜索问题：复杂搜索请在词之间使用 OR。搜索结果取决于 Outlook 内置的搜索功能。
• 服务器崩溃或邮件访问错误：检查 Outlook 连接是否稳定，以及该邮件编号是否存在于当前列表中。