Outlook 日历 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

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: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- calendar: Calendar name (optional)

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

创建日历事件

create_event
- subject: Event subject/title
- startDate: Start date in MM/DD/YYYY format
- startTime: Start time in HH:MM AM/PM format
- endDate: End date in MM/DD/YYYY format (optional)
- endTime: End time in HH:MM AM/PM format (optional)
- location: Event location (optional)
- body: Event description (optional)
- isMeeting: Whether this is a meeting with attendees (optional)
- attendees: Semicolon-separated list of attendee email addresses (optional)
- calendar: Calendar name (optional)

示例："周五下午 2 点与 John 关于项目提案的会议"

查找空闲时间段

find_free_slots
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- duration: Duration in minutes (optional)
- workDayStart: Work day start hour (0-23) (optional)
- workDayEnd: Work day end hour (0-23) (optional)
- calendar: Calendar name (optional)

示例："这周我什么时候有空进行 1 小时的会议？"

获取参与者状态

get_attendee_status
- eventId: Event ID
- calendar: Calendar name (optional)

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

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

更新日历事件

update_event
- eventId: Event ID to update
- subject: New event subject/title (optional)
- startDate: New start date in MM/DD/YYYY format (optional)
- startTime: New start time in HH:MM AM/PM format (optional)
- endDate: New end date in MM/DD/YYYY format (optional)
- endTime: New end time in HH:MM AM/PM format (optional)
- location: New event location (optional)
- body: New event description (optional)
- calendar: Calendar name (optional)

示例："将我明天的团队会议时间从下午 2 点改为下午 3 点"

获取日历

get_calendars

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

安全注意事项

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

故障排除

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

贡献

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

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

许可证

此项目根据 MIT 许可证许可 - 详情请参见LICENSE文件。