🚀 Outlook日历MCP工具

这是一个Model Context Protocol（MCP）服务器，允许Claude访问和管理本地Microsoft Outlook日历，仅限Windows系统使用，为用户提供便捷的日历操作体验。

🚀 快速开始

Outlook日历MCP工具是一个允许Claude访问和管理本地Microsoft Outlook日历的MCP服务器。在使用前，请确保满足以下先决条件：

• 操作系统：Windows 7 或更高版本
• Outlook：Microsoft Outlook 2013 或更高版本，或 Microsoft Outlook 365
• Node.js：v8.0.0 或更高版本
• npm：v5.0.0 或更高版本

✨ 主要特性

• 查看日历事件：可查看所有日历事件。
• 创建日历事件：能够添加新的日历事件。
• 更新日历事件：支持修改现有日历事件。
• 删除日历事件：可删除不需要的日历事件。
• 获取 attendee 状态：可以检查attendee的响应状态。
• 查找空闲时间：能查找可用时间段。
• 获取日历列表：可显示所有可用日历。

📦 安装指南

方法一：使用npm安装

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

方法二：从源代码安装

1. 克隆仓库：

   git clone https://github.com/your-username/outlook-calendar-mcp-tool.git
   cd outlook-calendar-mcp-tool
   

2. 安装依赖：

   npm install
   

📚 详细文档

配置说明

MCP服务器配置

针对Claude Desktop App：

{
  "operations": {
    "outlookCalendar": {
      "enabled": true,
      "configurations": {
        "pathToOutlook": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
        "defaultCalendar": "Personal Calendar"
      }
    }
  }
}

针对Claude VSCode扩展：

{
  "outlookCalendarMcpTool": {
    "outlookPath": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
    "defaultCalendarName": "Personal Calendar"
  }
}

使用指南

命令说明

查看日历事件

list_events [--calendar <日历名称>] [--start <开始日期>] [--end <结束日期>]

创建日历事件

create_event --title <标题> --start <开始时间> --end <结束时间> [--location <地点>] [--description <描述>] [--calendar <日历名称>]

更新日历事件

update_event --id <事件ID> [--title <新标题>] [--start <新开始时间>] [--end <新结束时间>] [--location <新地点>] [--description <新描述>] [--calendar <目标日历>]

删除日历事件

delete_event --id <事件ID>

获取 attendee 状态

get_attendee_status --event-id <事件ID>

查找空闲时间

find_available_time [--duration <持续时间>] [--start <开始时间>] [--end <结束时间>]

获取日历列表

get_calendars

🔧 技术细节

安全注意事项

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

故障排除

• Outlook安全提示：遇到安全提示时，请按照提示允许脚本访问您的Outlook数据。
• 脚本执行策略问题：如果出现脚本执行错误，请检查并调整您的PowerShell执行策略。
• 路径问题：确保配置文件中的路径指向正确的工具位置。

🤝 项目贡献

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

📄 许可证

本项目遵从MIT许可证，具体条款详见LICENSE文件。