Work IQ カレンダー リファレンス (プレビュー)

Important

  • これはプレビュー機能です。
  • プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能は追加使用条件の対象であり、公式リリース前にアクセス可能です。これにより、お客様は早期に利用し、フィードバックを提供することができます。

概要

サーバー ID 表示名称 説明
mcp_CalendarTools ワークIQカレンダー カレンダー ツール用の MCP サーバー。 この MCP サーバーは、イベントの作成、更新、取得、招待の管理、空き時間の確認などのカレンダー操作に使用します。

Note

  • Microsoft Teams MCP サーバーなど、以前のバージョンの Microsoft MCP サーバーを使用する既存の接続は引き続きサポートされます。
  • すべての新しい接続には、Work IQ Teams などの最新の Work IQ MCP サーバーを使用します。

使用可能なツール

mcp_CalendarTools_graph_acceptEvent

ユーザーのカレンダーで指定したイベントの招待を承諾します。

[Required parameters]\(必須のパラメーター\):

  • eventId: 受け入れるイベントの ID

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • コメント: 応答に含まれる省略可能なテキスト
  • sendResponse: 開催者に応答を送信するかどうか

mcp_カレンダーツール_キャンセルイベント

指定したユーザーのカレンダーのイベントをキャンセルし、参加者に通知します。

[Required parameters]\(必須のパラメーター\):

  • eventId: キャンセルするイベントのユニークID

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • コメント: 省略可能なキャンセル メッセージ

mcp_カレンダーツールズ_グラフ_イベント作成

指定したユーザーのカレンダーに新しいカレンダー イベントを作成します。 定期イベントとオンライン会議をサポートします。

[Required parameters]\(必須のパラメーター\):

  • subject: イベントの件名/タイトル(空ではない)
  • start: dateTime および timeZone を使ったタイムスタンプの開始
  • end: dateTime および timeZone を使用してタイムスタンプを終了する。
  • attendees_addresses: 出席者のメール アドレスの配列

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • body: contentType (Text/HTML) とコンテンツを含むイベント本文
  • location: displayNameとともに位置
  • attendees_types: 出席者ロール (必須、省略可能、リソース)
  • attendees_names: 出席者の表示名
  • 繰り返し: 繰り返しパターンと範囲
  • isOnlineMeeting: オンライン会議の場合は true に設定
  • onlineMeetingProvider: teamsForBusinessskypeForBusinessskypeForConsumer
  • allowNewTimeProposals: 時間提案を許可する (既定値: true)
  • transactionId: Idempotence 識別子

mcp_CalendarTools_グラフ_イベント拒否

ユーザーのカレンダーで指定したイベントの招待を辞退します。

[Required parameters]\(必須のパラメーター\):

  • eventId: 拒否するイベントの ID

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName

  • comment: 応答の省略可能なテキスト

  • sendResponse: 応答を送信するかどうか

mcp_CalendarTools_graph_イベントを削除する

指定したユーザーのカレンダーからイベントを削除します。

[Required parameters]\(必須のパラメーター\):

  • eventId:削除対象のイベントのユニークな識別子

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

開催者と参加者の空き時間に基づいて、会議の時間と場所を提案します。

[Required parameters]\(必須のパラメーター\):

  • meetingDuration: 会議の期間 (例: 'PT1H')

オプション パラメーター:

  • userId: 開催者 ID または userPrincipalName
  • attendees_addresses: 出席者のメール アドレス
  • attendees_types: 出席者の種類
  • attendees_names: 出席者の表示名
  • timeConstraint: timeslotsactivityDomain の時間の利用可能性
  • locationConstraint: 場所のオプション
  • maxCandidates: 最大提案候補
  • isOrganizerOptional: オーガナイザー 任意のフラグ
  • returnSuggestionReasons: 理由を含める
  • minimumAttendeePercentage: 最小出席しきい値

mcp_CalendarTools_graph_getEvent

指定したユーザーのカレンダーから 1 つのカレンダー イベントを取得します。

[Required parameters]\(必須のパラメーター\):

  • eventId: イベントのユニークな識別子

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • select: OData \$select クエリ パラメーター
  • expand: ナビゲーション プロパティの OData \$expand

mcp_CalendarTools_グラフ_スケジュール取得

ユーザー、配布リスト、またはリソースの空き/予約済みスケジュールを取得します。

[Required parameters]\(必須のパラメーター\):

  • スケジュール: ユーザーまたはリソースの SMTP アドレス
  • startTime: dateTimetimeZone を使った開始時間
  • endTime: dateTimetimeZone の終了時刻

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • availabilityViewInterval: 時間スロットの長さ (分)

mcp_CalendarTools_graph_listCalendarView

ユーザーの指定した時間の範囲内のカレンダーの出現回数を取得します。

[Required parameters]\(必須のパラメーター\):

  • startDateTime: 時間範囲の開始 (ISO 8601)
  • endDateTime: 時間範囲の終了 (ISO 8601)

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • top: イベントの最大数
  • orderby: Order by 句

mcp_CalendarTools_graph_listEvents

指定したユーザーのカレンダーからイベントの一覧を取得します。

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • startDateTime: 時間範囲の開始 (ISO 8601)
  • endDateTime: 時間範囲の終了 (ISO 8601)
  • top: イベントの最大数
  • filter: OData フィルター クエリ
  • orderby: OData クエリで並べ替え

mcp_CalendarTools_graph_updateEvent

指定したユーザーのカレンダーの既存カレンダー イベントを更新します。

[Required parameters]\(必須のパラメーター\):

  • eventId: イベントのユニークID

オプション パラメーター:

  • userId: ユーザー ID または userPrincipalName
  • 件名: 更新された件名
  • body: 更新された本文の内容
  • start: 更新された開始時刻
  • end: 更新された終了時刻
  • location: 更新された場所
  • attendees_addresses: 出席者のメールを更新しました
  • attendees_types: 更新された出席者の種類
  • attendees_names: 出席者の名前を更新しました
  • isCancelled: キャンセルする場合は true に設定
  • recurrence: 更新された繰り返しパターン

主な機能

イベント管理

  • イベントの作成、読み取り、更新、および削除
  • 招待の承諾、辞退、キャンセル
  • 定期イベントのサポート
  • オンライン会議との統合 (Teams、Skype)

空き時間とスケジュール

  • 空き/予約済みスケジュールを取得する
  • 空き時間確認を使用して会議時間を検索する
  • 時間の範囲フィルター処理を使用したカレンダー ビュー
  • 参加者の空き時間分析

参加者の管理

  • 必須、オプション、およびリソースの参加者を管理する
  • 時間提案のサポート
  • 回答の追跡
  • 配布リストのサポート

繰り返しパターン

  • 日次、週次、月次、年次のパターン
  • 絶対的および相対的繰り返し
  • 終了日または発生回数
  • 曜日と月の仕様

オンライン会議

  • Teams for Business との統合
  • Skype for Businessのサポート
  • Skypeのサポート (個人用)
  • 自動会議リンクの生成

メモ

  • すべてのタイムスタンプは、タイムゾーン付きの UTC/ISO 8601 形式を使用します
  • カレンダーMCPは組織内のユーザーを見つけるために UserprofileMCP に依存しています
  • メール アドレスは有効な形式である必要があります
  • 参加者の配列 (アドレス、タイプ、名前) は同じ順序にする必要があります
  • オンライン会議には isOnlineMeeting=trueonlineMeetingProvider
  • 繰り返しには、パターン オブジェクトと範囲オブジェクトの両方が必要です
  • タイム ゾーンは、開始時刻と終了時刻で一貫している必要があります
  • TransactionId イベント作成 idempotent を可能にします