Outlook Calendar

🚀 微软 Outlook 日历 MCP 工具

这是一个模型上下文协议（MCP）服务器，允许Claude访问并管理您本地的Microsoft Outlook日历（仅限Windows），为您的日历管理带来便利。

🚀 快速开始

该工具是一个模型上下文协议（MCP）服务器，可让Claude访问并管理本地的Microsoft Outlook日历（仅支持Windows系统）。使用前需满足一定的先决条件，并完成安装和配置，即可使用相关命令对日历进行管理。

✨ 主要特性

• 查看日历事件：可在指定日期范围内列出事件，查看事件详细信息，检查与会者状态。
• 管理日历事件：支持创建新的事件和会议，更新现有事件。
• 日历智能：能查找空闲时间间隔以安排会议，识别最佳开会时间。
• 支持多个日历：可访问您Outlook配置文件中的不同日历。

📦 安装指南

先决条件

• Windows 操作系统
• Microsoft Outlook 安装并运行
• Node.js (建议版本 14.0 或更高)
• npm (建议版本 6.0 或更高)

安装方式

方式一：使用npm安装

1. 打开命令提示符或PowerShell。
2. 运行以下命令：

   npm install outlook-calendar-mcp-tool --save
   

3. 按照提示完成安装。

方式二：手动安装

1. 下载工具压缩包。
2. 解压文件到指定目录。
3. 在命令提示符或PowerShell中运行：

   cd <解压目录>
   npm start
   

📚 详细文档

配置

步骤一：允许脚本访问Outlook

1. 打开Outlook。
2. 点击菜单栏的“文件” > “选项” > “信任中心” > “宏设置”。
3. 勾选“启用所有宏”并点击“确定”。

步骤二：配置环境变量

在系统环境中添加以下变量：

• 变量名：OUTLOOK_PROFILE
• 变量值：您的Outlook配置文件路径（例如：C:\Users\Username\AppData\Roaming\Microsoft\Outlook）

使用说明

命令列表

• list-events [calendarName]：列出指定日历的所有事件。
• add-event <eventTitle>：添加新的日历事件。
• update-event <eventId> <newTitle>：更新现有事件的标题。
• delete-event <eventId>：删除指定的事件。
• get-calendar-info：获取所有可用日历信息。

示例

列出事件

node index.js list-events "工作"

添加事件

node index.js add-event 新项目会议

更新事件

node index.js update-event 12345 新项目规划会议

删除事件

node index.js delete-event 12345

获取日历信息

node index.js get-calendar-info

安全提示

⚠️ 重要提示

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

故障排除

💡 使用建议

• Outlook 安全提示：如果看到安全提示，请允许脚本访问您的Outlook数据。
• 脚本执行策略：如果遇到脚本执行错误，可能需要调整PowerShell执行策略。
• 路径问题：确保环境变量配置正确。

贡献指南

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

通过参与此项目，您同意遵守我们的 行为准则。

📄 许可证

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