Microsoft 365 Teams

@mindstone/mcp-server-microsoft-teams

Microsoft 365 Teams MCP 服务——通过 Microsoft Graph API 列出和读取 Teams 聊天及频道消息、发送消息和回复、发起新聊天、查找同事、搜索消息，以及读取或设置在线状态。

面向 Microsoft 365 Teams 的 Cohort 风格 MCP。它复用由 @mindstone/mcp-server-microsoft-mail 管理的 OAuth 接口，因此宿主只需登录一次，即可使用 Teams、邮件、日历、文件和 SharePoint，共用同一组凭据。

状态

• 版本： 0.3.1 · npm
• 身份验证： OAuth（由宿主协调，与 mcp-server-microsoft-mail 共用）(MS_CLIENT_ID)
• 工具： 17（聊天、消息、团队、频道、用户、搜索、在线状态）
• 接口类型： cloud-api
• 机器可读信息： STATUS.json
• 共享库： @mindstone/mcp-server-microsoft-shared

为什么要开发它

2026 年 5 月移植此项目时，Microsoft 自家的 Graph MCP 产品线尚未推出独立的 Teams 服务，而当时的社区方案都将 Teams 视为独立的登录入口——每个连接器都要单独进行 OAuth 流程，并各自保存一份刷新令牌。我们将 MindstoneRebel 中打包的连接器独立出来，按 1:1 移植，使同一组由五个连接器组成的 Microsoft 365 Cohort（邮件、日历、文件、Teams、SharePoint）能够共用一组凭据、一个用于令牌持久化和请求超时的共享库包，以及宿主已能够处理的结构化 auth_required 响应。Teams 复用 @mindstone/mcp-server-microsoft-mail 的 authenticate_microsoft_account 工具，而不是自行声明该工具。部分 Teams Graph API 可能需要租户管理员批准——请参阅 Microsoft 的 Teams Graph 文档。

交互示例

“显示我与 Alice 和 Bob 的项目聊天中最近的 10 条消息。”

宿主调用的工具：

1. list_chats — 按参与者 [email protected] 和 [email protected] 筛选聊天。
2. list_chat_messages — 返回已解析聊天 ID 中最新的 10 条消息。

响应（节选）：

{
  "chat": {
    "id": "19:[email protected]",
    "topic": "Project planning",
    "members": ["[email protected]", "[email protected]"]
  },
  "messages": [
    { "id": "171...", "from": "Alice", "body": "Pushed the updated forecast", "createdDateTime": "2026-05-19T08:42:00Z" }
  ]
}

要求

• Node.js 20+
• npm
• 能够执行 Microsoft OAuth 流程，并将每个帐户的令牌文件写入 ${MS_CONFIG_DIR}/credentials/${sanitised-email}.token.json，同时将 ${MS_CONFIG_DIR}/accounts.json 作为索引写入的宿主应用。本服务读取这些文件；不会自行发起 OAuth 流程。

一键安装

点击按钮后，宿主将提示你填写：MS_CLIENT_ID、MS_CONFIG_DIR、MS_MCP_PACKAGE_ID、MICROSOFT_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Microsoft 365 Teams": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-microsoft-teams"
      ],
      "env": {
        "MS_CLIENT_ID": "",
        "MS_CONFIG_DIR": "",
        "MS_MCP_PACKAGE_ID": "Microsoft365Teams",
        "MICROSOFT_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

快速开始

安装和构建

cd <path-to-repo>/connectors/microsoft-teams
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-microsoft-teams

本地

node dist/index.js

配置

此服务与负责 Microsoft 365 OAuth 流程的宿主应用一同运行。宿主会将凭据写入磁盘；此服务会读取这些凭据。

必需的环境变量

可选的环境变量

宿主配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Microsoft365Teams": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-microsoft-teams"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

请先通过 @mindstone/mcp-server-microsoft-mail 登录并调用 authenticate_microsoft_account；随后 Teams 工具会复用其写入 ${MS_CONFIG_DIR}/ 的凭据。

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Microsoft365Teams": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/microsoft-teams/dist/index.js"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

工具（17）

某些 Teams Graph API 可能需要租户管理员批准。标注了所需权限的工具会预先检查已连接帐户的令牌；如果缺少权限，则会提供可行的重新连接指引（根据 Microsoft 的托管授权政策，在大多数租户中，ChannelMessage.Read.All 需要管理员授权）。

安全说明

• 本身不提供身份验证工具；登录委托给 @mindstone/mcp-server-microsoft-mail，使该工具组共用一个 OAuth 接入点。
• 每个工具的 Graph 调用都会使用组合后的调用方和工具组超时信号运行。

许可证

FSL-1.1-MIT — Functional Source License，1.1 版，未来采用 MIT 许可证。可免费用于非竞争用途；在 LICENSE 中规定的转换日期重新授权为 MIT。