Outlook Calendar MCP

🚀 Outlook Calendar MCP Tool

This is a Model Context Protocol (MCP) server that allows Claude to access and manage the local Microsoft Outlook calendar, only available on Windows systems.

🚀 Quick Start

This Outlook Calendar MCP Tool is a Model Context Protocol (MCP) server designed to enable Claude to access and manage the local Microsoft Outlook calendar. It is exclusively available for Windows systems.

✨ Features

• View Calendar Events: View all calendar events.
• Create Calendar Events: Add new calendar events.
• Update Calendar Events: Modify existing calendar events.
• Delete Calendar Events: Delete unwanted calendar events.
• Get Attendee Status: Check the response status of attendees.
• Find Free Time: Find available time slots.
• Get Calendar List: Display all available calendars.

📦 Installation

Method 1: Install via npm

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

Method 2: Install from Source Code

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

📚 Documentation

Prerequisites

• Operating System: Windows 7 or higher.
• Outlook: Microsoft Outlook 2013 or higher, or Microsoft Outlook 365.
• Node.js: v8.0.0 or higher.
• npm: v5.0.0 or higher.

Configuration Instructions

MCP Server Configuration

For Claude Desktop App:

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

For Claude VSCode Extension:

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

Usage Guide

Command Explanation

View Calendar Events

list_events [--calendar <Calendar Name>] [--start <Start Date>] [--end <End Date>]

Create Calendar Events

create_event --title <Title> --start <Start Time> --end <End Time> [--location <Location>] [--description <Description>] [--calendar <Calendar Name>]

Update Calendar Events

update_event --id <Event ID> [--title <New Title>] [--start <New Start Time>] [--end <New End Time>] [--location <New Location>] [--description <New Description>] [--calendar <Target Calendar>]

Delete Calendar Events

delete_event --id <Event ID>

Get Attendee Status

get_attendee_status --event-id <Event ID>

Find Free Time

find_available_time [--duration <Duration>] [--start <Start Time>] [--end <End Time>]

Get Calendar List

get_calendars

Security Precautions

• When using the tool for the first time, Outlook may display a security prompt. Please allow the script to access your Outlook data.
• This tool only accesses the local Outlook client and does not send calendar data to external servers.
• All calendar operations are performed locally on your computer.

Troubleshooting

• Outlook Security Prompt: When encountering a security prompt, follow the prompt to allow the script to access your Outlook data.
• Script Execution Policy Issue: If a script execution error occurs, check and adjust your PowerShell execution policy.
• Path Issue: Ensure that the paths in the configuration file point to the correct tool locations.

Contributing to the Project

Welcome to contribute to the Outlook Calendar MCP Tool! Please refer to our Contribution Guide to learn how to get started.

📄 License

This project is licensed under the MIT License. For detailed terms, please refer to the LICENSE file.