Outlook Calendar MCP

Created By

merajmehrabi10 months ago

The Outlook Calendar MCP enables Claude to directly manage Microsoft Outlook calendars on Windows systems, offering a privacy-focused solution that keeps all data local. Users can view events, create meetings, find free time slots, and manage multiple calendars without their data leaving their machine.

# outlook

# calendar

Overview Content Tools Comments

Content

# Outlook Calendar MCP Tool

A Model Context Protocol (MCP) server that allows Claude to access and manage your local Microsfot Outlook calendar (Windows only).

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\](https://opensource.org/licenses/MIT)

Features

**View Calendar Events**: List events within a date range, view event details, check attendee status
**Manage Calendar Events**: Create new events and meetings, update existing events
**Calendar Intelligence**: Find free time slots for scheduling, identify optimal meeting times
**Multiple Calendar Support**: Access different calendars in your Outlook profile

Prerequisites

Windows operating system
Microsoft Outlook desktop client installed
Node.js (version 14.x or higher)
npm (comes with Node.js)

Installation

Option 1: Install from npm

```bash npm install -g outlook-calendar-mcp ```

You can also run it directly without installation using npx:

```bash npx outlook-calendar-mcp ```

Option 2: Install from source

Clone this repository or download the source code
Install dependencies:

```bash npm install ```

Run the server:

```bash npm start ```

MCP Server Configuration

To use this tool with Claude, you need to add it to your MCP settings configuration file.

For Claude Desktop App

Add the following to your Claude Desktop configuration file (located at `%APPDATA%\Claude\claude_desktop_config.json`):

If installed globally via npm:

```json { "mcpServers": { "outlook-calendar": { "command": "outlook-calendar-mcp", "args": [], "env": {} } } } ```

Using npx (without installation):

```json { "mcpServers": { "outlook-calendar": { "command": "npx", "args": ["-y", "outlook-calendar-mcp"], "env": {} } } } ```

If installed from source:

```json { "mcpServers": { "outlook-calendar": { "command": "node", "args": ["path/to/outlook-calendar-mcp/src/index.js"], "env": {} } } } ```

For Claude VSCode Extension

Add the following to your Claude VSCode extension MCP settings file (located at `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`):

If installed globally via npm:

```json { "mcpServers": { "outlook-calendar": { "command": "outlook-calendar-mcp", "args": [], "env": {} } } } ```

Using npx (without installation):

```json { "mcpServers": { "outlook-calendar": { "command": "npx", "args": ["-y", "outlook-calendar-mcp"], "env": {} } } } ```

If installed from source:

```json { "mcpServers": { "outlook-calendar": { "command": "node", "args": ["path/to/outlook-calendar-mcp/src/index.js"], "env": {} } } } ```

For source installation, replace `path/to/outlook-calendar-mcp` with the actual path to where you installed this tool.

Usage

Once configured, Claude will have access to the following tools:

List Calendar Events

``` list_events

startDate: Start date in MM/DD/YYYY format
endDate: End date in MM/DD/YYYY format (optional)
calendar: Calendar name (optional) ```

Example: "List my calendar events for next week"

Create Calendar Event

``` 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) ```

Example: "Add a meeting with John about the project proposal on Friday at 2 PM"

Find Free Time Slots

``` 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) ```

Example: "When am I free for a 1-hour meeting this week?"

Get Attendee Status

``` get_attendee_status

eventId: Event ID
calendar: Calendar name (optional) ```

Example: "Who hasn't responded to my team meeting invitation?"

**Important Note**: When using operations that require an event ID (update_event, delete_event, get_attendee_status), you must use the `id` field from the list_events response. This is the unique EntryID that Outlook uses to identify events.

Update Calendar Event

``` 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) ```

Example: "Update my team meeting tomorrow to start at 3 PM instead of 2 PM"

Get Calendars

``` get_calendars ```

Example: "Show me my available calendars"

Security Notes

On first use, Outlook may display security prompts to allow script access
The tool only accesses your local Outlook client and does not send calendar data to external servers
All calendar operations are performed locally on your computer

Troubleshooting

**Outlook Security Prompts**: If you see security prompts from Outlook, you need to allow the script to access your Outlook data
**Script Execution Policy**: If you encounter script execution errors, you may need to adjust your PowerShell execution policy
**Path Issues**: Ensure the path in your MCP configuration file points to the correct location of the tool