Outlook Calendar MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Outlook 日历 MCP 工具

模型上下文协议 (MCP) 服务器允许 Claude 访问和管理您的本地 Microsfot 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 Desktop 配置文件(位于%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 日历 MCP 工具做出贡献!请参阅我们的贡献指南,了解如何开始贡献。

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

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Outlook 日历 MCP 使 Claude 能够直接在 Windows 系统上管理 Microsoft Outlook 日历,从而提供注重隐私的解决方案,将所有数据保存在本地。用户可以查看活动、创建会议、查找空闲时间段以及管理多个日历,而无需将数据离开设备。

  1. Features
    1. Prerequisites
      1. Installation
        1. Option 1: Install from npm
        2. Option 2: Install from source
      2. MCP Server Configuration
        1. For Claude Desktop App
        2. For Claude VSCode Extension
      3. Usage
        1. List Calendar Events
        2. Create Calendar Event
        3. Find Free Time Slots
        4. Get Attendee Status
        5. Update Calendar Event
        6. Get Calendars
      4. Security Notes
        1. Troubleshooting
          1. Contributing
            1. License
              ID: 08enllwrbp