金大哥 - Outlook for macOS MCP 详情

article

README

🚀 用于 macOS 的 Claude Outlook MCP 工具

这是一个模型上下文协议 (MCP) 工具，允许 Claude 与 Microsoft Outlook for macOS 进行交互，实现邮件、日历和联系人等功能的便捷操作。

🚀 快速开始

在使用该工具前，请确保满足以下先决条件：

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

✨ 主要特性

邮件：
- 阅读未读和普通邮件
- 搜索关键词电子邮件
- 使用收件人、抄送和密送发送电子邮件
- 发送 HTML 格式邮件
- 附件文件到电子邮件中
- 列出邮箱文件夹
日历：
- 查看今天的活动
- 查看即将进行的活动
- 搜索事件
- 创建新的日历事件
联系人：
- 列示联系人
- 按名称搜索联系人

📦 安装指南

克隆此仓库：

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

安装依赖项：

bun install

确保脚本可执行：

chmod +x index.ts

更新您的 claude_desktop_config.json 配置文件，指向新位置。

💻 使用示例

基础用法

发送邮件

{
  "messages": [
    {
      "role": "user",
      "content": "发送一封电子邮件给 john@example.com，主题是 '会议提醒'，内容是 '别忘了明天的会议。'"
    }
  ]
}

响应

{
  "messages": [
    {
      "role": "assistant",
      "content": "已向 john@example.com 发送邮件。"
    }
  ],
  "status": "success"
}

创建日历事件

{
  "messages": [
    {
      "role": "user",
      "content": "创建一个明天下午 2 点的会议提醒，标题是 '团队会议'。"
    }
  ]
}

响应

{
  "messages": [
    {
      "role": "assistant",
      "content": "已创建 '团队会议' 日历事件。"
    }
  ],
  "status": "success"
}

高级用法

设置提醒

通过在请求中添加 settings 字段，可以自定义响应行为：

{
  "messages": [
    {
      "role": "user",
      "content": "发送一封电子邮件给 john@example.com 提醒他会议。"
    }
  ],
  "settings": {
    "提醒时间": "1小时前",
    "重要性": "高"
  }
}

🔧 技术细节

模块找不到错误

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

确保已运行 bun install 安装所有依赖项

尝试显式安装 MCP SDK：

bun add @modelcontextprotocol/sdk@^1.5.0

检查模块是否存在：

ls -la node_modules/@modelcontextprotocol/sdk/server/

如果问题仍然存在，请创建新项目：

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

然后复制文件并运行：

bun install
bun run index.ts

最后，更新您的 claude_desktop_config.json 配置文件以指向新位置。

📄 许可证

MIT

Outlook for macOS