home / mcp / outlook mcp server

Outlook MCP Server

This is an MCP (Model Context Protocol) server for integration with Microsoft Outlook. It operates the local Outlook client on Windows via COM, providing email reading, summarization, and draft generation features. Its main advantage is fast deployment on Windows without complex security authentication.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cqyefeng119-windows-outlook-mcp": {
      "command": "node",
      "args": [
        "path\\\\to\\\\windows-outlook-mcp\\\\dist\\\\index.js"
      ]
    }
  }
}

This Outlook MCP Server provides a unified way to access and control Outlook email and calendar from an MCP client. It runs locally on Windows via COM and PowerShell, enabling fast setup and secure, centralized automation for common Outlook tasks.

How to use

You use a compatible MCP client to communicate with the Outlook MCP Server. The server exposes functions to manage email and calendar, such as listing emails, reading message details, drafting responses, creating or updating calendar events, and finding free time slots. Connect your client to the local MCP endpoint, then call the available functions by name as actions in your automation scripts.

How to install

Prerequisites you need to meet before installing the server are listed here so you can prepare your environment.

Step 1: Verify system requirements

- Windows 10/11

- Microsoft Outlook installed and configured

- Node.js 16.0 or higher

- PowerShell 5.0 or higher

Step 2: Install dependencies

pnpm install

Step 3: Compile TypeScript

npm run build

Step 4: Configure the MCP client integration

{
  "mcpServers": {
    "outlook": {
      "type": "stdio",
      "command": "node",
      "args": ["path\\to\\windows-outlook-mcp\\dist\\index.js"],
      "env": {}
    }
  }
}

Available tools

get_inbox_emails

Retrieve a list of inbox emails from Outlook.

get_sent_emails

Retrieve a list of emails sent from your Outlook account.

get_draft_emails

Retrieve a list of draft emails.

get_email_by_id

Get details for a specific email by its ID.

search_inbox_emails

Search inbox emails by keywords.

search_sent_emails

Search sent emails by keywords.

search_draft_emails

Search draft emails by keywords.

mark_email_as_read

Mark a specific email as read.

summarize_email

Summarize a single email with priority awareness.

summarize_inbox

Batch summarize inbox emails, grouped by priority.

create_draft

Create a new email draft with recipients, subject, and body.

duplicate_email_as_draft

Duplicate an existing email as a new draft, preserving formatting.

list_events

List calendar events within a date range.

create_event_with_show_as

Create a calendar event with a specific Show As status (Free/Busy/OutOfOffice, etc.).

set_show_as

Set the Show As status for an existing event.

update_event

Update details of an existing calendar event.

delete_event

Delete a calendar event by its ID.

find_free_slots

Find available time slots within specified work hours.

get_attendee_status

Check the response status of meeting attendees.

get_calendars

List all available calendars.