viartemev/outlook-ews-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

13 stars 6 forks 质量 82 趋势 29MIT

Repository Install

使用电子邮件、日历、联系人、文件夹、附件和免费/繁忙可用性工具,为Prem Microsoft Exchange(EWS)保护MCP服务器.

概览

展望-ews-mcp是一款通过EWS(Exchangelib)用于prem上微软交换的MCP服务器. 它通过一个单一的,可测试的Python服务——不需要直接的邮箱脚本,使MCP兼容客户端(Claude Desktop,Claude Code,以及任何其他MCP客户端)能够访问电子邮件,日历,联系人,文件夹,附件,以及可用数据. 这个名称已经被一个无关的项目取入了PyPI上,所以现在的发行和CLI名称是展望-ews-mcp. Python 导入路径不变。在第一个标记的 PyPI 发布之前, 从此寄存器安装如下 .

概述（AI 翻译）

英语

outlook-ews-mcp是用于上微软的MCP服务器通过EWS([T1])进行交换. 它给兼容 MCP 客户端( Claude Desktop, Claude Code, 以及其他 MCP 客户端) 访问电子邮件、日历、联系人、文件夹、附件和通过单一的、可测试 Python 服务——不需要直接邮箱脚本.

** 从outlook-mcp改名。 ** 这个名字已经被一个无关的人在PyPI上取了 project,所以现在的分布和CLI名称是[[T3]. Python 导入路径不变. 在第一个标记的 PyPI 发布之前, 从此寄存器安装为如下所示。

□ 目录

重点
工具目录
典型的使用情况
安全说明
快开始
配置
答复草案、展望报告以及发出确认函
请求队列
克洛德桌面/克洛德代码示例
检查烟雾
达克
排雷中心/CD
发展
项目说明
贡献
执照

□ 重点

电子邮件——列表,搜索(subtring或高级查询语法),读取,发送,回复, 前进、移动、复制、删除、标记、分类、散装动作、原始MIME导出、添加/删除附件

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

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.

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

在 GitHub 查看完整 README

安装

docker run --rm --env-file .env outlook-ews-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "outlook": {
      "command": "/path/to/outlook-ews-mcp/.venv/bin/outlook-ews-mcp",
      "env": {
        "EXCHANGE_SERVER": "https://mail.company.com/EWS/Exchange.asmx",
        "EXCHANGE_USERNAME": "DOMAIN\\username",
        "EXCHANGE_PASSWORD": "secret",
        "EXCHANGE_EMAIL_ADDRESS": "[email protected]",
        "EXCHANGE_AUTH_TYPE": "NTLM"
      }
    }
  }
}