home / mcp / outlook calendar mcp server

Outlook Calendar MCP Server

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

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "merajmehrabi-outlook_calendar_mcp": {
      "command": "outlook-calendar-mcp",
      "args": []
    }
  }
}

This MCP server lets Claude access and manage your local Microsoft Outlook calendar from your computer. It runs as a local service that talks directly to your Outlook client, enabling you to view events, create or update meetings, find free time, and check attendee statuses without leaving your desk.

How to use

After you configure the MCP server in your preferred Claude client, you can invoke the calendar tools directly from Claude. You can list events in a date range, create or update events, identify open time slots for scheduling, and check attendee responses. All calendar actions operate against your local Outlook data and do not transmit information over the internet.

How to install

Prerequisites you need installed on your system are Node.js (version 14.x or higher) and npm, plus Windows with Microsoft Outlook installed. If you plan to use the npm installation method, you can install globally or run via npx.

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

```bash
npx outlook-calendar-mcp

Configuration and usage examples

Configure Claude to access the MCP server using one of the available runtime options. The following examples show the MCP entries you would place in the client configuration.

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

For Claude Desktop App

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

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

Using npx (without installation)

If you prefer to run without installing globally, use npx with the same command:

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

If installed from source

If you built from source, point Claude to the local Node entry point.

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

Available tools

list_events

List calendar events within a date range and optionally for a specific Outlook calendar, showing details and attendee status.

create_event

Create a new event or meeting with a subject, date and time, location, description, and optional attendees.

find_free_slots

Find free time slots across a calendar by considering a start/end window, duration, and workday boundaries.

get_attendee_status

Retrieve attendee responses for a specific event to see who has accepted, declined, or not responded.

update_event

Modify an existing event’s subject, time, location, details, or calendar.

get_calendars

List available calendars in your Outlook profile.