local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Used as the JavaScript runtime to execute the MCP server code.
Required as the operating system environment for running the MCP tool with macOS-specific Outlook integration.

Claude Outlook MCP 工具

这是一个模型上下文协议 (MCP) 工具，允许 Claude 与 macOS 的 Microsoft Outlook 进行交互。

特征

邮件：
- 阅读未读邮件和常规邮件
- 按关键字搜索电子邮件
- 发送包含收件人、抄送人和密送人的电子邮件
- 发送 HTML 格式的电子邮件
- 将文件附加到电子邮件
- 列出邮件文件夹
日历：
- 查看今天的活动
- 查看即将举行的活动
- 搜索活动
- 创建新的日历事件
联系方式：
- 列出联系人
- 按姓名搜索联系人

先决条件

搭载 Apple Silicon (M1/M2/M3) 或 Intel 芯片的 macOS
安装并配置Microsoft Outlook for Mac
包子安装好了
已安装Claude 桌面应用程序

安装

克隆此存储库：

git clone https://github.com/syedazharmbnr1/claude-outlook-mcp.git
cd claude-outlook-mcp

安装依赖项：

bun install

确保脚本是可执行的：

chmod +x index.ts

更新您的 Claude Desktop 配置：

编辑您的claude_desktop_config.json文件（位于~/Library/Application Support/Claude/claude_desktop_config.json ）以包含此工具：

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "/Users/YOURUSERNAME/.bun/bin/bun",
      "args": ["run", "/path/to/claude-outlook-mcp/index.ts"]
    }
  }
}

确保将YOURUSERNAME替换为您的实际 macOS 用户名，并调整到您克隆此存储库的路径。

重启 Claude 桌面应用程序
授予权限：
- 前往“系统偏好设置”>“隐私和安全”>“隐私”
- 授予终端（或您首选的终端应用程序）访问辅助功能的权限
- 首次使用该工具时，您可能会看到权限提示

用法

安装完成后，您可以通过询问以下问题直接从 Claude 使用 Outlook 工具：

“你能在 Outlook 中查看我未读的电子邮件吗？”
“在我的 Outlook 电子邮件中搜索季度报告”
“向john@example.com发送一封电子邮件，主题为‘明天开会’”
“我今天的日历上有什么安排？”
“创建明天下午 2 点的会议”
“查找 Jane Smith 的联系信息”

示例

电子邮件操作

Check my unread emails in Outlook

Send an email to alex@example.com with subject "Project Update" and the following body: Here's the latest update on our project. We've completed phase 1 and are moving on to phase 2.

Send an HTML email to team@example.com with subject "Weekly Report" and attach the quarterly_results.pdf file

Search my emails for "budget meeting"

日历操作

What events do I have today?

Create a calendar event for a team meeting tomorrow from 2pm to 3pm

Show me my upcoming events for the next 2 weeks

联系运营

List all my Outlook contacts

Search for contact information for Jane Smith

高级功能

HTML 电子邮件支持

您可以通过将isHtml参数设置为 true 来发送丰富的 HTML 格式的电子邮件：

Send an HTML email to john@example.com with the subject "Project Update" and body "<h1>Project Update</h1><p>We've made <b>significant progress</b> on the project.</p>"

文件附件

您可以通过在attachments参数中提供文件路径将文件附加到电子邮件中：

Send an email to jane@example.com with subject "Monthly Report" and attach the reports/march_2025.pdf file

为了获得最佳附件效果：

尽可能使用绝对文件路径
确保运行 MCP 工具的进程可以访问这些文件
附件将自动通过强大的错误检测进行处理

故障排除

如果您遇到附件问题：

检查文件是否存在且可读
使用绝对文件路径而不是相对路径
确保运行该进程的用户有权读取该文件

如果遇到错误Cannot find module '@modelcontextprotocol/sdk/server/index.js' ：

确保已运行bun install来安装所有依赖项
尝试明确安装 MCP SDK：
bun add @modelcontextprotocol/sdk@^1.5.0
检查模块是否存在于您的 node_modules 目录中：
ls -la node_modules/@modelcontextprotocol/sdk/server/

如果错误仍然存在，请尝试使用 Bun 创建一个新项目：

mkdir -p ~/yourpath/claude-outlook-mcp
cd ~/yourpath/claude-outlook-mcp
bun init -y

然后将 package.json 和 index.ts 文件复制到新目录并运行：

bun install
bun run index.ts

更新您的 claude_desktop_config.json 以指向新位置。

执照

麻省理工学院

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

模型上下文协议工具使 Claude 能够与 macOS 的 Microsoft Outlook 进行交互，允许用户通过自然语言命令阅读/发送电子邮件、管理日历事件和访问联系人。

Related Resources

Reddit Discussion about this server

Claude Outlook MCP Tool