Outlook Calendar MCP 工具

一个模型上下文协议 (MCP) 服务器，允许 Claude 访问和管理您的本地 Microsoft Outlook 日历（仅限 Windows）。

功能

• 查看日历事件: 列出指定日期范围内的事件，查看事件详情，检查参与者状态
• 管理日历事件: 创建新的事件和会议，更新现有事件
• 日历智能: 查找可用于安排日程的空闲时间段，确定最佳会议时间
• 多日历支持: 访问 Outlook 配置文件中的不同日历

前提条件

• Windows 操作系统
• 已安装 Microsoft Outlook 桌面客户端
• Node.js (14.x 或更高版本)
• npm (随 Node.js 一起提供)

安装

选项 1：从 npm 安装

npm install -g outlook-calendar-mcp

您也可以直接运行它，无需安装，使用 npx：

npx outlook-calendar-mcp

选项 2：从源代码安装

1. 克隆此存储库或下载源代码
2. 安装依赖项：

npm install

3. 运行服务器：

npm start

MCP 服务器配置

要将此工具与 Claude 一起使用，您需要将其添加到您的 MCP 设置配置文件中。

对于 Claude 桌面应用程序

将以下内容添加到您的 Claude 桌面配置文件（位于 %APPDATA%\Claude\claude_desktop_config.json）：

如果通过 npm 全局安装：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

使用 npx（无需安装）：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

对于 Claude VSCode 扩展

将以下内容添加到您的 Claude VSCode 扩展 MCP 设置文件（位于 %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json）：

如果通过 npm 全局安装：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

使用 npx（无需安装）：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

对于源代码安装，请将 path/to/outlook-calendar-mcp 替换为您安装此工具的实际路径。

用法

配置完成后，Claude 将可以访问以下工具：

列出日历事件

list_events
- startDate: 开始日期，格式为 MM/DD/YYYY
- endDate: 结束日期，格式为 MM/DD/YYYY (可选)
- calendar: 日历名称 (可选)

示例: "列出我下周的日历事件"

创建日历事件

create_event
- subject: 事件主题/标题
- startDate: 开始日期，格式为 MM/DD/YYYY
- startTime: 开始时间，格式为 HH:MM AM/PM
- endDate: 结束日期，格式为 MM/DD/YYYY (可选)
- endTime: 结束时间，格式为 HH:MM AM/PM (可选)
- location: 事件地点 (可选)
- body: 事件描述 (可选)
- isMeeting: 是否为与会者的会议 (可选)
- attendees: 以分号分隔的与会者电子邮件地址列表 (可选)
- calendar: 日历名称 (可选)

示例: "在星期五下午 2 点添加一个与 John 讨论项目提案的会议"

查找空闲时间段

find_free_slots
- startDate: 开始日期，格式为 MM/DD/YYYY
- endDate: 结束日期，格式为 MM/DD/YYYY (可选)
- duration: 持续时间，以分钟为单位 (可选)
- workDayStart: 工作日开始时间 (0-23) (可选)
- workDayEnd: 工作日结束时间 (0-23) (可选)
- calendar: 日历名称 (可选)

示例: "我这周什么时候有空参加一个 1 小时的会议？"

获取参与者状态

get_attendee_status
- eventId: 事件 ID
- calendar: 日历名称 (可选)

示例: "谁还没有回复我的团队会议邀请？"

重要提示: 当使用需要事件 ID 的操作（update_event, delete_event, get_attendee_status）时，您必须使用 list_events 响应中的 id 字段。 这是 Outlook 用于标识事件的唯一 EntryID。

更新日历事件

update_event
- eventId: 要更新的事件 ID
- subject: 新的事件主题/标题 (可选)
- startDate: 新的开始日期，格式为 MM/DD/YYYY (可选)
- startTime: 新的开始时间，格式为 HH:MM AM/PM (可选)
- endDate: 新的结束日期，格式为 MM/DD/YYYY (可选)
- endTime: 新的结束时间，格式为 HH:MM AM/PM (可选)
- location: 新的事件地点 (可选)
- body: 新的事件描述 (可选)
- calendar: 日历名称 (可选)

示例: "将我明天的团队会议更新为下午 3 点开始，而不是下午 2 点"

获取日历

get_calendars

示例: "显示我可用的日历"

安全注意事项

• 首次使用时，Outlook 可能会显示安全提示，以允许脚本访问
• 该工具仅访问您的本地 Outlook 客户端，不会将日历数据发送到外部服务器
• 所有日历操作都在您的计算机本地执行

故障排除

• Outlook 安全提示: 如果您看到来自 Outlook 的安全提示，您需要允许脚本访问您的 Outlook 数据
• 脚本执行策略: 如果您遇到脚本执行错误，您可能需要调整您的 PowerShell 执行策略
• 路径问题: 确保您的 MCP 配置文件中的路径指向该工具的正确位置

贡献

我们欢迎对 Outlook Calendar MCP 工具的贡献！ 请参阅我们的 贡献指南 以了解如何开始。

参与本项目即表示您同意遵守我们的 行为准则。

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。