Microsoft 365 Teams

@mindstone/mcp-server-microsoft-teams

Microsoft 365 Teams 用 MCP サーバーです。Teams のチャットやチャネルのメッセージの一覧表示と読み取り、メッセージや返信の送信、新しいチャットの開始、同僚の検索、メッセージの検索、Microsoft Graph API を介したプレゼンスの読み取りと設定ができます。

コホート形式の Microsoft 365 Teams MCP です。ホストが一度サインインするだけで、同じ認証情報を使って Teams、メール、カレンダー、ファイル、SharePoint を利用できるよう、@mindstone/mcp-server-microsoft-mail が管理する OAuth の仕組みを再利用します。

ステータス

• バージョン： 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 の同じ 5 つのコネクター（メール、カレンダー、ファイル、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 に管理者の同意が必要です）。

セキュリティに関する注意事項

• 独自の認証ツールはありません。コホートで OAuth の接続先を一元化するため、サインインは @mindstone/mcp-server-microsoft-mail に委任されます。
• ツールごとの Graph 呼び出しは、呼び出し元とコホートのタイムアウトシグナルを合成して実行されます。

ライセンス

FSL-1.1-MIT — MIT による将来のライセンス付与を含む Functional Source License バージョン 1.1 です。競合しない用途であれば無料で使用でき、LICENSE に記載された変換日に MIT ライセンスへ移行します。