Microsoft 365 Calendar

@mindstone/mcp-server-microsoft-calendar

Microsoft 365 Outlook Calendar MCP サーバーです。Microsoft Graph API 経由で、イベントの一覧表示、取得、作成、更新、削除、キャンセル、返信、空き時間の確認、会議時間の検索、カレンダーの一覧表示を行えます。

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

ステータス

• バージョン： 0.2.0 · npm
• 認証： OAuth（ホストがオーケストレーション。認証は mcp-server-microsoft-mail と共有）(MS_CLIENT_ID)
• ツール： 10（イベント、カレンダー、空き時間、スケジュール調整）
• サーフェス： cloud-api
• 機械可読データ： STATUS.json
• 共有ライブラリ： @mindstone/mcp-server-microsoft-shared

開発の背景

2026年5月にこのサーバーを移植した時点では、Microsoft の Graph MCP のラインアップに、単独で利用できる Outlook Calendar サーバーはまだありませんでした。また、当時のコミュニティ製の選択肢では、カレンダーが独立した認証対象として扱われており、コネクターごとに別々の OAuth 認証を行い、更新トークンも個別に保存する必要がありました。そこで、MindstoneRebel に含まれていたコネクターを 1 対 1 で移植し、5 つの Microsoft 365 コネクター（メール、カレンダー、ファイル、Teams、SharePoint）で一組の認証情報と、トークンの永続化およびリクエストタイムアウトを扱う共有ライブラリパッケージを共用できるようにしました。また、ホストがすでに復旧処理に対応している構造化された auth_required エンベロープも共用します。カレンダーでは独自のツールを定義せず、@mindstone/mcp-server-microsoft-mail の authenticate_microsoft_account ツールを再利用します。

やり取りの例

「今日の午後の予定を確認して、明日、Alice と私の両方が空いている 30 分の時間枠を探してください。」

ホストが呼び出すツール：

1. list_events — 今日の残りの時間を含む日付範囲を指定します。
2. find_meeting_times — 明日、Alice とユーザーの両方が空いている時間枠を提案します。

応答（一部抜粋）：

{
  "today": [
    { "id": "AA...=", "subject": "Q3 review", "start": "2026-05-19T15:00:00Z", "end": "2026-05-19T16:00:00Z" }
  ],
  "tomorrow_suggestions": [
    { "start": "2026-05-20T10:00:00", "end": "2026-05-20T10:30:00" },
    { "start": "2026-05-20T14:30:00", "end": "2026-05-20T15:00:00" }
  ]
}

要件

• 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 Calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-microsoft-calendar"
      ],
      "env": {
        "MS_CLIENT_ID": "",
        "MS_CONFIG_DIR": "",
        "MS_MCP_PACKAGE_ID": "Microsoft365Calendar",
        "MICROSOFT_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

クイックスタート

インストールとビルド

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

npx（公開後）

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

ローカル

node dist/index.js

設定

このサーバーは、Microsoft 365 の OAuth フローを管理するホストアプリケーションと連携して動作します。ホストが認証情報をディスクに書き込み、このサーバーがそれを読み取ります。

必須の環境変数

任意の環境変数

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Microsoft365Calendar": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-microsoft-calendar"],
      "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 を使ってサインインしてください。その後、カレンダーツールはそこに書き込まれた認証情報を ${MS_CONFIG_DIR}/ から再利用します。

ローカル開発（npm への公開は不要）

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

ツール（10）

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

• 独自の認証ツールはありません。コホート内で OAuth の窓口を一本化するため、サインインは @mindstone/mcp-server-microsoft-mail に委任されます。
• トークンファイルはホストによってモード 0600 で書き込まれます。このサーバーはコホート共有ライブラリ経由でトークンファイルを読み取り、不正な形式のファイルは安全側に倒して拒否します。
• クラウド環境では、デスクトップセッションのみがリフレッシュトークンを更新できるよう、MICROSOFT_DISABLE_REFRESH=1 がデフォルトで設定されています。
• ツールごとの Graph 呼び出しには、呼び出し元とコホートのタイムアウトシグナルを合成したものが適用されます。
• Graph 由来のテキストはすべて <untrusted-content> エンベロープ内で返されます。構造化されているように見えるフィールド（ID、URL、列挙型のような値、タイムスタンプ）は、文書化された制約形式に一致する場合のみそのまま渡され、それ以外はエンベロープに格納されます。モデルに届く前に、ベンダーのエラーメッセージもエンベロープに格納されます。
• Graph リクエストを行う前に、ツール入力（メールアドレス、ISO 形式の日付時刻、範囲が制限された数値、厳格な繰り返しオブジェクト）を検証し、不正な入力は安全側に倒して拒否します。
• Graph リクエストパスに組み込まれるイベント／カレンダー ID は、ネットワークリクエストの前に検証し、不正な ID は安全側に倒して拒否します（?、#、%、\、空白、.／.. セグメントを拒否）。組み込み箇所では URL エンコードするため、細工された ID によって認証済みリクエストの送信先が変更されることはありません。
• Graph のページネーション結果を黙って破棄することはありません。一覧表示エンドポイントは、ベンダー指定の継続 URL をたどる代わりに truncated／attachmentsTruncated を報告します。

ライセンス

FSL-1.1-MIT — Functional Source License バージョン 1.1。将来的に MIT ライセンスとなります。競合しない用途では無料で利用でき、LICENSE に記載された変換日に MIT ライセンスへ再ライセンスされます。