outlook-ews-mcp

English · Русский

outlook-ews-mcp is an MCP server for on-prem Microsoft Exchange via EWS (exchangelib). It gives MCP-compatible clients (Claude Desktop, Claude Code, and any other MCP client) access to email, calendar, contacts, folders, attachments, and availability data through a single, testable Python service — no direct mailbox scripting required.

Renamed from outlook-mcp. That name was already taken on PyPI by an unrelated project, so the distribution and CLI name are now outlook-ews-mcp. The Python import path is unchanged. Until the first tagged PyPI release, install from this repository as shown below.

Contents

• Highlights
• Tool catalog
• Typical use cases
• Security notes
• Quick start
• Configuration
• Reply drafts, Outlook mentions, and send confirmation
• Request queue
• Claude Desktop / Claude Code example
• Smoke check
• Docker
• CI/CD
• Development
• Project notes
• Contributing
• License

Highlights

• Email — list, search (substring or Advanced Query Syntax), read, send, reply, forward, move, copy, delete, mark, categorize, bulk actions, raw MIME export, attachment add/delete
• System — Inbox Rules, Out-of-Office (automatic replies), read-only delegate listing
• Calendar — list, create, update, delete, respond to invites, find free slots, view a shared/delegate mailbox’s calendar, Room Finder, bulk actions
• Contacts — search, read, create, update, delete
• Folders & attachments — folder CRUD and attachment download
• Auth — NTLM and Basic against on-prem Exchange
• Transport — stdio, Streamable HTTP and (deprecated) SSE; HTTP requires a bearer token
• Architecture — centralized error mapping through a single ExchangeClient abstraction (see Project notes)
• Safety — a privacy-safer smoke check by default (see Smoke check)
• Ops — Docker image plus GitHub and GitLab CI/CD pipelines included

Tool catalog

Every tool below is registered in tool_specs.py, the single source of truth for its name, description, and schema. Read-only marks tools