Outlook Calendar MCP Tool 使用说明

项目简介

Outlook Calendar MCP Tool 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在让大型语言模型 (LLM)，如 Claude，能够安全地访问和操作您的本地 Microsoft Outlook 桌面客户端的日历数据。通过此工具，LLM可以帮助您更智能地管理日程，例如查询日程安排、创建新的会议或活动、查找空闲时间等。

主要功能点

查看日程：查询指定日期范围内的日历事件，包括事件详情和参会者状态。
创建日程：创建新的日历事件和会议，支持设置主题、时间、地点、描述和参会者。
查找空闲时间：在指定日期范围内查找可用于安排会议或活动的空闲时间段。
管理参会者：查询会议参会者的接受状态。
更新和删除日程：修改已有的日历事件，或根据事件ID删除指定事件。
多日历支持：支持访问Outlook中配置的多个日历。

安装步骤

环境准备：
- 操作系统：Windows (仅支持Windows系统)
- 邮件客户端：Microsoft Outlook 桌面客户端 (已安装并配置账户)
- 运行环境：Node.js (版本 14.x 或更高) 和 npm (随 Node.js 安装)

安装方式 (选择一种方式即可):

方式一：通过 npm 全局安装
```
npm install -g outlook-calendar-mcp
```
安装完成后，您可以使用命令 'outlook-calendar-mcp' 启动服务器。
方式二：使用 npx 运行 (无需安装)
```
npx outlook-calendar-mcp
```
使用 npx 可以直接运行，无需全局安装。

方式三：从源代码安装

git clone [仓库URL]  # 或者下载源代码压缩包并解压
cd Outlook_Calendar_MCP # 进入项目目录
npm install         # 安装项目依赖
npm start           # 启动服务器

请将 '[仓库URL]' 替换为仓库的实际URL：'https://github.com/merajmehrabi/Outlook_Calendar_MCP'。

服务器配置 (MCP 客户端配置)

要将此 MCP 服务器与 MCP 客户端（例如 Claude）配合使用，您需要在 MCP 客户端的配置文件中添加服务器配置信息。以下是针对不同安装方式的配置示例，请根据您的安装方式选择相应的配置添加到 MCP 客户端的配置文件中。

注意： 以下提供的 JSON 配置信息是用于配置 MCP 客户端的，不是用于配置 Outlook Calendar MCP Tool 服务器自身的。您只需将以下 JSON 代码块复制粘贴到 MCP 客户端的配置文件中，并根据注释进行必要的路径调整（如果选择从源代码安装）。

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"],  // 将 "/path/to/Outlook_Calendar_MCP" 替换为您的实际项目路径
      "env": {}
    }
  }
}

请务必将 '/path/to/Outlook_Calendar_MCP' 替换为您实际存放 'Outlook_Calendar_MCP' 项目的完整路径。

Claude VSCode 扩展配置 ( '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"],  // 将 "/path/to/Outlook_Calendar_MCP" 替换为您的实际项目路径
      "env": {}
    }
  }
}

同样，请务必将 '/path/to/Outlook_Calendar_MCP' 替换为您实际存放 'Outlook_Calendar_MCP' 项目的完整路径。

基本使用方法

完成服务器配置后，您的 MCP 客户端（如 Claude）将能够识别并调用 Outlook Calendar MCP Tool 提供的工具。您可以通过自然语言指令，指示 LLM 使用相应的工具来操作您的 Outlook 日历。

例如，您可以指示 Claude 执行以下操作：

"列出下周的日程安排" (对应 'list_events' 工具)
"明天下午2点安排一个与 John 关于项目提案的会议" (对应 'create_event' 工具)
"本周我什么时候有空开一个小时的会议？" (对应 'find_free_slots' 工具)

具体的工具名称和参数请参考仓库的 'README.md' 文件中 "Usage" 部分的详细说明。

安全提示: 首次运行时，Outlook 可能会弹出安全提示，询问是否允许脚本访问您的日历数据，请选择“允许”。此工具仅在您的本地计算机上运行，不会将日历数据发送到外部服务器。

关键词