Rube MCP を使用した Outlook 自動化

Composio の Outlook ツールキットを通じて、Rube MCP で Microsoft Outlook の操作を自動化します。

前提条件

• Rube MCP が接続されている（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット outlook を使用した RUBE_MANAGE_CONNECTIONS 経由でアクティブな Outlook 接続
• 常に RUBE_SEARCH_TOOLS を呼び出して、最新のツールスキーマを取得

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加してください。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認
2. RUBE_MANAGE_CONNECTIONS をツールキット outlook で呼び出す
3. 接続が ACTIVE でない場合、返されたAuthリンクをたどって Microsoft OAuth を完了
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認

コア ワークフロー

1. メールの検索とフィルター

使用する場面: ユーザーがメールボックス全体から特定のメールを見つけたいとき

ツールシーケンス:

1. OUTLOOK_SEARCH_MESSAGES - KQL 構文を使用してすべてのフォルダで検索 [必須]
2. OUTLOOK_GET_MESSAGE - メッセージの詳細情報を取得 [オプション]
3. OUTLOOK_LIST_OUTLOOK_ATTACHMENTS - メッセージの添付ファイルをリスト [オプション]
4. OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT - 添付ファイルをダウンロード [オプション]

主要パラメータ:

• query: KQL 検索文字列 (from:, to:, subject:, received:, hasattachment:)
• from_index: ページネーション開始（0 ベース）
• size: ページあたりの結果数（最大 25）
• message_id: メッセージ ID（検索結果の hitId を使用）

落とし穴:

• Microsoft 365/Enterprise アカウントのみで動作（@hotmail.com/@outlook.com は非対応）
• ページネーションは hitsContainers[0].moreResultsAvailable に依存します。false の場合のみ停止
• 下流の呼び出しでは、resource.id ではなく検索結果の hitId を message_id として使用
• インデックス遅延: 最新のメールはすぐに表示されない場合があります
• インライン画像は添付ファイルとして表示されます。実際のドキュメントは mimetype でフィルター

2. フォルダ内のメールをクエリ

使用する場面: ユーザーが特定のフォルダ内のメールを OData フィルター付きでリストしたいとき

ツールシーケンス:

1. OUTLOOK_LIST_MAIL_FOLDERS - メールフォルダをリストしてフォルダ ID を取得 [前提条件]
2. OUTLOOK_QUERY_EMAILS - 構造化フィルターでメールをクエリ [必須]

主要パラメータ:

• folder: フォルダ名（'inbox', 'sentitems', 'drafts'）またはフォルダ ID
• filter: OData フィルター（例: isRead eq false and importance eq 'high'）
• top: 最大結果数（1-1000）
• orderby: ソートフィールドと方向
• select: 返すフィールドの配列

落とし穴:

• QUERY_EMAILS は単一フォルダのみを検索します。フォルダ間の検索には SEARCH_MESSAGES を使用
• カスタムフォルダは表示名ではなくフォルダ ID が必要です。LIST_MAIL_FOLDERS を使用
• 常に response['@odata.nextLink'] でページネーションを確認
• 受信者または本文内容でフィルターできません。SEARCH_MESSAGES を使用してください

3. カレンダーイベントの管理

使用する場面: ユーザーがカレンダーイベントをリスト、検索、または確認したいとき

ツールシーケンス:

1. OUTLOOK_LIST_EVENTS - フィルター付きでイベントをリスト [オプション]
2. OUTLOOK_GET_CALENDAR_VIEW - 時間範囲内のイベントを取得 [オプション]
3. OUTLOOK_GET_EVENT - 特定のイベント詳細を取得 [オプション]
4. OUTLOOK_LIST_CALENDARS - 利用可能なカレンダーをリスト [オプション]
5. OUTLOOK_GET_SCHEDULE - 空き情報を取得 [オプション]

主要パラメータ:

• filter: OData フィルター（receivedDateTime ではなく start/dateTime を使用）
• start_datetime/end_datetime: カレンダービューの ISO 8601
• timezone: IANA タイムゾーン（例: 'America/New_York'）
• calendar_id: オプションの非プライマリカレンダー ID
• select: 返すフィールド

落とし穴:

• カレンダーイベントプロパティのみを使用してください（start/dateTime, end/dateTime）。メールプロパティ（receivedDateTime）は使用しないでください
• カレンダービューは start_datetime と end_datetime が必要
• 定期的なイベントは個別の出現を見るために expand_recurring_events=true が必要
• 辞退ステータスは attendees[].status.response で参加者ごと

4. 連絡先の管理

使用する場面: ユーザーが連絡先をリスト、作成、または整理したいとき

ツールシーケンス:

1. OUTLOOK_LIST_CONTACTS - 連絡先をリスト [オプション]
2. OUTLOOK_CREATE_CONTACT - 新しい連絡先を作成 [オプション]
3. OUTLOOK_GET_CONTACT_FOLDERS - 連絡先フォルダをリスト [オプション]
4. OUTLOOK_CREATE_CONTACT_FOLDER - 連絡先フォルダを作成 [オプション]

主要パラメータ:

• givenName/surname: 連絡先名
• emailAddresses: メールオブジェクトの配列
• displayName: フルディスプレイ名
• contact_folder_id: 連絡先用のオプションフォルダ

落とし穴:

• 連絡先作成は多くのフィールドをサポートしていますが、givenName または surname のいずれかのみが必要

5. メールフォルダの管理

使用する場面: ユーザーがメールフォルダを整理したいとき

ツールシーケンス:

1. OUTLOOK_LIST_MAIL_FOLDERS - トップレベルフォルダをリスト [必須]
2. OUTLOOK_LIST_CHILD_MAIL_FOLDERS - サブフォルダをリスト [オプション]
3. OUTLOOK_CREATE_MAIL_FOLDER - 新しいフォルダを作成 [オプション]

主要パラメータ:

• parent_folder_id: よく知られた名前またはフォルダ ID
• displayName: 新しいフォルダ名
• include_hidden_folders: 隠しフォルダを表示

落とし穴:

• よく知られたフォルダ名: 'inbox', 'sentitems', 'drafts', 'deleteditems', 'junkemail', 'archive'
• カスタムフォルダ操作は表示名ではなくフォルダ ID が必要

一般的なパターン

KQL 検索構文

プロパティフィルター:

• from:user@example.com - 送信者から
• to:recipient@example.com - 受信者へ
• subject:invoice - 件名に含む
• received>=2025-01-01 - 日付フィルター
• hasattachment:yes - 添付ファイルあり

結合子:

• AND - 両方の条件
• OR - いずれかの条件
• グループ化用の括弧

OData フィルター構文

メールフィルター:

• isRead eq false - 未読メール
• importance eq 'high' - 高い重要度
• hasAttachments eq true - 添付ファイルあり
• receivedDateTime ge 2025-01-01T00:00:00Z - 日付フィルター

カレンダーフィルター:

• start/dateTime ge '2025-01-01T00:00:00Z' - 日付以降のイベント
• contains(subject, 'Meeting') - 件名にテキストを含む

既知の落とし穴

アカウントタイプ:

• SEARCH_MESSAGES は Microsoft 365/Enterprise アカウントが必要
• 個人アカウント（@hotmail.com, @outlook.com）は API アクセスが限定的

フィールドの混乱:

• メールプロパティ（receivedDateTime）とカレンダープロパティ（start/dateTime）は異なります
• カレンダークエリでメールフィールドを使用したり、その逆をしないでください

クイックリファレンス

タスク	ツール スラッグ	主要パラメータ
メールを検索	OUTLOOK_SEARCH_MESSAGES	query, from_index, size
フォルダをクエリ	OUTLOOK_QUERY_EMAILS	folder, filter, top
メッセージを取得	OUTLOOK_GET_MESSAGE	message_id
添付ファイルをリスト	OUTLOOK_LIST_OUTLOOK_ATTACHMENTS	message_id
添付ファイルをダウンロード	OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT	message_id, attachment_id
フォルダをリスト	OUTLOOK_LIST_MAIL_FOLDERS	（なし）
子フォルダ	OUTLOOK_LIST_CHILD_MAIL_FOLDERS	parent_folder_id
イベントをリスト	OUTLOOK_LIST_EVENTS	filter, timezone
カレンダービュー	OUTLOOK_GET_CALENDAR_VIEW	start_datetime, end_datetime
イベントを取得	OUTLOOK_GET_EVENT	event_id
カレンダーをリスト	OUTLOOK_LIST_CALENDARS	（なし）
空き情報	OUTLOOK_GET_SCHEDULE	schedules, times
連絡先をリスト	OUTLOOK_LIST_CONTACTS	top, filter
連絡先を作成	OUTLOOK_CREATE_CONTACT	givenName, emailAddresses
連絡先フォルダ	OUTLOOK_GET_CONTACT_FOLDERS	（なし）

使用時期

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、タスクが上記で説明されたスコープと明らかに一致する場合のみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替として扱わないでください。
• 必要な入力、権限、安全な境界、または成功基準が不明な場合は、停止して明確にしてください。