返回市场
outlook日历MCP

outlook日历MCP

作者:merajmehrabi31 星标更新:2025-09-21

项目介绍

Outlook 日历 MCP 工具

这是一个模型上下文协议(MCP)服务器,允许 Claude 访问并管理您本地的 Microsoft Outlook 日历(仅限 Windows 操作系统)。

<a href="https://glama.ai/mcp/servers/08enllwrbp"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=3154675600,2569317196&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Outlook 日历 MCP 服务器" /> </a>

License: MIT

功能

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

先决条件

  • Windows 操作系统
  • 安装了 Microsoft Outlook 桌面客户端
  • VBScript 支持(如果您使用的是 Windows 11 24H2 或更高版本,请参阅下方的 VBScript 安装部分)
  • Node.js(版本 14.x 或更高)
  • npm(随 Node.js 一起提供)

VBScript 安装(适用于 Windows 11 24H2 用户)

重要提示:从 Windows 11 24H2 开始,VBScript 不再默认安装,必须作为可选功能启用。

如果您在 Windows 更新后遇到 MCP 服务器无法正常工作的问题,可能需要安装 VBScript:

  1. 打开 设置(Windows + I)
  2. 转到 应用可选功能
  3. 点击 “添加可选功能” 旁边的 “查看功能”
  4. 搜索 “VBScript”
  5. 选择 VBScript 并点击 安装
  6. 安装完成后重新启动计算机

VBScript 废除时间表:

  • 第一阶段(2024年末+):作为 Windows 11 24H2 的可选功能可用
  • 第二阶段(约2027年):将不再默认启用
  • 第三阶段(未来):完全从 Windows 中移除

注释:感谢社区关于 VBScript 废除的反馈,我正在考虑架构改进以使项目更具前瞻性。

安装

方案 1:通过 npm 安装

npm install -g outlook-calendar-mcp

您也可以不进行安装直接运行:

npx outlook-calendar-mcp

方案 2:从源代码安装

  1. 克隆此仓库或下载源代码
  2. 安装依赖项:
npm install
  1. 运行服务器:
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 客户端,并不会将日历数据发送到外部服务器
  • 所有日历操作都在您的计算机上本地执行

故障排除

  • VBScript 不可用(Windows 11 24H2+):如果在 Windows 更新后遇到错误,可能需要安装 VBScript。请参阅上方的 VBScript 安装 部分
  • “脚本执行失败”错误:通常表示 VBScript 不可用或无法访问 Outlook
  • Outlook 安全提示:如果看到来自 Outlook 的安全提示,您需要允许脚本访问您的 Outlook 数据
  • 脚本执行策略:如果遇到脚本执行错误,您可能需要调整 PowerShell 执行策略
  • 路径问题:确保 MCP 配置文件中的路径指向工具的正确位置

贡献

我们欢迎对 Outlook 日历 MCP 工具的贡献!请参阅我们的 贡献指南,了解如何开始。

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

许可证

该项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。