Microsoft 365 MCP Server

通过模型上下文协议（MCP）实现完整的 Microsoft 365 集成。

功能

📧 邮件（Outlook）

• 列出、阅读、发送和搜索邮件
• 按文件夹筛选（收件箱、已发送、草稿）
• 支持 HTML 邮件

📅 日历

• 列出和创建日程事件
• 集成 Teams 会议
• 检查用户可用性/忙闲状态（free-busy）

📁 OneDrive

• 浏览文件和文件夹
• 搜索文件
• 读取文件内容

✅ 任务（Microsoft To-Do）

• 列出任务列表
• 创建和管理任务
• 设置任务重要性和截止日期

💬 Teams

• 列出聊天会话
• 读取和发送消息

👥 用户

• 列出组织内用户
• 获取用户资料

系统要求

• Node.js 18+
• 已配置 Microsoft Graph 权限的 Azure Entra ID 应用

安装与配置

1. 创建 Azure Entra ID 应用

1. 访问 Azure 门户
2. 导航至 Microsoft Entra ID → 应用注册 → 新注册
3. 配置以下选项：
   • 名称：MCP-Microsoft365
   • 支持的账户类型：仅此组织目录中的账户（单租户，推荐）
   • 重定向 URI：http://localhost:3000/callback

2. 添加 API 权限

为 Microsoft Graph 添加以下 应用程序权限（Application permissions）：

Mail.Read, Mail.Send, Mail.ReadWrite
Calendars.Read, Calendars.ReadWrite
Files.Read.All, Files.ReadWrite.All
Tasks.Read.All, Tasks.ReadWrite.All
Chat.Read.All, Chat.ReadWrite.All
User.Read.All

注意：请务必点击“授予管理员同意”按钮。

3. 获取凭据

请保存以下值：

• 应用程序（客户端）ID
• 目录（租户）ID
• 客户端密钥（在“证书和密码”中创建）

4. 安装

# 克隆或下载该技能模块
cd mcp-microsoft365

# 安装依赖
npm install

# 构建
npm run build

5. 配置 mcporter

mcporter config add m365 --stdio "node /path/to/mcp-microsoft365/dist/index.js"

编辑 config/mcporter.json 文件，添加环境变量：

{
  "mcpServers": {
    "m365": {
      "command": "node /path/to/dist/index.js",
      "env": {
        "TENANT_ID": "your-tenant-id",
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret",
        "DEFAULT_USER": "user@yourdomain.com"
      }
    }
  }
}

使用方法

邮件

# 列出最近的邮件
mcporter call m365.m365_mail_list top:5

# 发送邮件
mcporter call m365.m365_mail_send to:"recipient@email.com" subject:"Hello" body:"
Hi!
"

# 搜索邮件
mcporter call m365.m365_mail_search query:"important"

日历

# 列出日程事件
mcporter call m365.m365_calendar_list top:10

# 创建带 Teams 会议的日程事件
mcporter call m365.m365_calendar_create subject:"Team Sync" start:"2026-01-27T10:00:00" end:"2026-01-27T11:00:00" isOnline:true

文件

# 列出 OneDrive 根目录
mcporter call m365.m365_files_list

# 搜索文件
mcporter call m365.m365_files_search query:"report"

任务

# 列出任务列表
mcporter call m365.m365_tasks_lists

Teams

# 列出聊天会话
mcporter call m365.m365_teams_chats top:10

共提供 19 个工具

作者

Mahmoud Alkhatib

• 网站：malkhatib.com
• YouTube：@malkhatib
• Twitter：@malkhateeb

许可证

MIT