Skip to main content
Glama
Jpatching

mcp-outlook-desktop

by Jpatching

Microsoft Outlook MCP Server for Claude & Antigravity (AGY)

PyPI CI

A high-performance Model Context Protocol (MCP) server providing direct, secure access to your Microsoft 365 Outlook emails, calendar, and contacts from:

  • Claude Code CLI

  • Claude Desktop

  • Antigravity CLI (AGY)


🖥️ Live Terminal Demo

> claude "Check my unread emails and prepare a draft follow-up to Alex about tomorrow's sync"

⚡ Calling Tool: outlook_list_messages(folder="inbox", unread_only=True, top=5)
✔ Found 2 unread messages:
  [1] From: Alex Mercer <alex@company.com> | Subject: Agenda for Q3 Planning Sync
  [2] From: Cloud Alerts <alerts@infra.io> | Subject: Weekly Node Health Report

⚡ Calling Tool: outlook_get_message(message_id="MSG_049281")
✔ Retrieved message safely encapsulated in <untrusted_email_body_content> boundary.

⚡ Calling Tool: outlook_create_draft(
    to_recipients=["alex@company.com"],
    subject="Re: Agenda for Q3 Planning Sync",
    body="Hi Alex,\n\nThanks for sending over the agenda. I reviewed the distributed queue items and added notes for tomorrow's sync.\n\nBest,\nJosh"
)
✔ Draft created successfully in Outlook Drafts folder (ID: DRAFT_839120)
  [Human-in-the-Loop Safe]: The draft is ready in your Outlook app for review before sending.

Related MCP server: outlook-mcp

🔒 Privacy & Security Architecture

  • Human-in-the-Loop by Design: All outbound message drafting defaults to your Outlook Drafts folder for manual review. Direct unreviewed sends (outlook_send_mail) require an explicit confirm_send=True flag to prevent accidental dispatches.

  • Indirect Prompt Injection Defense: Incoming email bodies are encapsulated in <untrusted_email_body_content> XML tags to ensure AI models parse external content strictly as passive data.

  • Zero Cloud Tokens / No Passwords: Connects 100% locally to your running Windows Outlook Desktop application via Windows MAPI (win32com).

  • Strict .gitignore: All local configs, caches, and environments are ignored.


🚀 Installation & Quickstart

Method 1: Instant Run with uvx (No git clone needed)

If you have uv installed, you can run the server directly:

uvx mcp-outlook-desktop

Claude Desktop Configuration (%APPDATA%\Claude\claude_desktop_config.json):

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

Claude Code CLI:

claude mcp add outlook uvx mcp-outlook-desktop

Method 2: Local Installation with pip

pip install mcp-outlook-desktop

Then in your Claude Desktop config:

{
  "mcpServers": {
    "outlook": {
      "command": "mcp-outlook"
    }
  }
}

Method 3: Clone from Source (C:\projects\mcp-outlook)

cd C:\projects
gh repo clone Jpatching/mcp-outlook
cd mcp-outlook
setup.bat

Test connection (with Outlook open):

run.bat --status
run.bat --test

🛠️ Available MCP Tools

Tool Name

Parameters

Description

outlook_check_status

none

Check connection to Outlook

outlook_list_messages

folder, top, unread_only

List recent emails from Inbox, Sent, Drafts

outlook_search_messages

query, top

Search messages across mailbox

outlook_get_message

message_id

Retrieve full email body and sender details safely encapsulated in XML boundaries

outlook_create_draft

subject, body, to_recipients, reply_to_message_id

Create a draft email or reply draft in Outlook Drafts folder (Recommended)

outlook_send_mail

subject, body, to_recipients, confirm_send

Send an email directly (diverts to Drafts unless confirm_send=True)

outlook_list_calendar_events

days_ahead

List upcoming meetings and appointments

outlook_create_calendar_event

subject, start_datetime, end_datetime, attendees, location

Schedule a meeting in Outlook Calendar

outlook_list_folders

none

List mail folders with unread counts

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Governed email for AI agents (Mailbuttons / mbag.ai): sandbox inboxes, policy gate, audit log.

  • Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.

  • Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jpatching/mcp-outlook'

If you have feedback or need assistance with the MCP directory API, please join our Discord server