wrike-automation

Rube MCP による Wrike の自動化

Rube MCP を介して Composio の Wrike ツールキットを利用し、Wrike のプロジェクト管理業務を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/wrike

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• wrike ツールキットを指定した RUBE_MANAGE_CONNECTIONS による、アクティブな Wrike 接続
• 必ず最初に RUBE_SEARCH_TOOLS を呼び出し、最新のツールスキーマを取得すること

セットアップ

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

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

主要なワークフロー

1. タスクの作成と管理

使用する場面：ユーザーが Wrike でタスクを作成、割り当て、または更新したい場合

ツールの呼び出し順序：

1. WRIKE_GET_FOLDERS - 対象のフォルダー／プロジェクトを探します［前提条件］
2. WRIKE_GET_ALL_CUSTOM_FIELDS - 必要に応じてカスタムフィールド ID を取得します［任意］
3. WRIKE_CREATE_TASK - 新しいタスクを作成します［必須］
4. WRIKE_MODIFY_TASK - タスクのプロパティを更新します［任意］

主なパラメーター：

• folderId：タスクを作成する親フォルダーの ID
• title：タスクのタイトル
• description：タスクの説明（HTML に対応）
• responsibles：割り当てるユーザー ID の配列
• status：'Active'、'Completed'、'Deferred'、'Cancelled'
• importance：'High'、'Normal'、'Low'
• customFields：{id, value} オブジェクトの配列
• dates：type、start、due、duration を含むオブジェクト

注意事項：

• folderId は必須です。タスクはフォルダーに属している必要があります
• responsibles には Wrike のユーザー ID が必要です。メールアドレスや名前は指定できません
• カスタムフィールド ID は GET_ALL_CUSTOM_FIELDS から取得する必要があります
• priorityBefore と priorityAfter は同時に指定できません
• Team プランでは Status フィールドを利用できない場合があります
• dates.start と dates.due は 'YYYY-MM-DD' 形式です

2. フォルダーとプロジェクトの管理

使用する場面：ユーザーがフォルダーやプロジェクトを作成、変更、または整理したい場合

ツールの呼び出し順序：

1. WRIKE_GET_FOLDERS - 既存のフォルダーを一覧表示します［必須］
2. WRIKE_CREATE_FOLDER - 新しいフォルダー／プロジェクトを作成します［任意］
3. WRIKE_MODIFY_FOLDER - フォルダーのプロパティを更新します［任意］
4. WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID - サブフォルダーを一覧表示します［任意］
5. WRIKE_DELETE_FOLDER - フォルダーを完全に削除します［任意］

主なパラメーター：

• folderId：作成時は親フォルダーの ID、変更時は対象フォルダーの ID
• title：フォルダー名
• description：フォルダーの説明
• customItemTypeId：フォルダーではなくプロジェクトとして作成する場合に設定します
• shareds：共有相手のユーザー ID またはメールアドレスの配列
• project：GET_FOLDERS でプロジェクト（true）またはフォルダー（false）を絞り込むためのフィルター

注意事項：

• DELETE_FOLDER は取り消せません。すべての内容（タスク、サブフォルダー、ドキュメント）が削除されます
• 親として rootFolderId または recycleBinId を変更することはできません
• フォルダーの作成時、作成者は自動的に共有相手に追加されます
• customItemTypeId を指定すると、フォルダーがプロジェクトに変換されます
• descendants=true を指定した GET_FOLDERS はフォルダーツリーを返します（大きなデータになる場合があります）

3. タスクの取得と追跡

使用するタイミング：タスクを検索したり、ステータスを確認したり、進捗を監視したりする場合

ツールの実行順序：

1. WRIKE_FETCH_ALL_TASKS - オプションのフィルターを使用してタスクを一覧表示します［必須］
2. WRIKE_GET_TASK_BY_ID - 特定のタスクの詳細情報を取得します［任意］

主なパラメーター：

• status：タスクのステータスで絞り込みます（'Active'、'Completed' など）
• dueDate：期限の範囲で絞り込みます（開始／終了／一致）
• fields：レスポンスに含める追加フィールド
• page_size：1ページあたりの結果数（1～100）
• taskId：詳細取得対象の特定のタスク ID
• resolve_user_names：ユーザー ID を名前に自動解決します（デフォルトは true）

注意点：

• FETCH_ALL_TASKS は、1ページあたり最大 100 件でページネーションされます
• dueDate フィルターでは、'equal'、'start'、'end' フィールドがサポートされています
• 日付形式：'yyyy-MM-dd' または 'yyyy-MM-ddTHH:mm:ss'
• GET_TASK_BY_ID は読み取り専用の詳細情報を返します
• 単一タスクのクエリでは、customFields がデフォルトで返されます

4. タスクのブループリントを起動

使用するタイミング：事前定義されたテンプレートからタスクを作成する場合

ツールの実行順序：

1. WRIKE_LIST_TASK_BLUEPRINTS - 利用可能なブループリントを一覧表示します［前提条件］
2. WRIKE_LIST_SPACE_TASK_BLUEPRINTS - 特定のスペース内のブループリントを一覧表示します［代替手段］
3. WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC - ブループリントを起動します［必須］

主なパラメーター：

• task_blueprint_id：起動するブループリントの ID
• title：ルートタスクのタイトル
• parent_id：親フォルダー／プロジェクトの ID（または super_task_id）
• super_task_id：親タスクの ID（または parent_id）
• reschedule_date：タスクの再スケジュール先の日付
• reschedule_mode：'RescheduleStartDate' または 'RescheduleFinishDate'
• entry_limit：コピーするタスクの最大数（1～250）

注意点：

• parent_id または super_task_id のいずれかが必要です。両方を指定することはできません
• ブループリントの起動は非同期です。タスクが表示されるまで時間がかかることがあります
• reschedule_date を指定するには、reschedule_mode の設定が必要です
• entry_limit により、ブループリントの起動ごとにコピーされるタスク／フォルダーは最大 250 件に制限されます
• copy_descriptions のデフォルトは false です。タスクの説明を含めるには true を設定します

5. ワークスペースとメンバーの管理

使用するタイミング：スペース、メンバー、または招待を管理する場合

ツールの実行順序：

1. WRIKE_GET_SPACE - スペースの詳細を取得します［任意］
2. WRIKE_GET_CONTACTS - ワークスペースの連絡先／メンバーを一覧表示します［任意］
3. WRIKE_CREATE_INVITATION - ユーザーをワークスペースに招待します［任意］
4. WRIKE_DELETE_SPACE - スペースを完全に削除します［任意］

主なパラメーター：

• spaceId：スペース識別子
• email：招待先のメールアドレス
• role：ユーザーのロール（'Admin'、'Regular User'、'External User'）
• firstName／lastName：招待する相手の名前

注意点：

• DELETE_SPACE は取り消せず、スペースのすべての内容が削除されます
• 招待では、userTypeId と role／external は相互に排他的です
• カスタムのメール件名／メッセージには、有料の Wrike プランが必要です
• GET_CONTACTS はワークスペース全体の連絡先を返します。タスク固有の担当者は返しません

よくあるパターン

フォルダー ID の解決

1. Call WRIKE_GET_FOLDERS (optionally with project=true for projects only)
2. Navigate folder tree to find target
3. Extract folder id (e.g., 'IEAGKVLFK4IHGQOI')
4. Use as folderId in task/folder creation

カスタムフィールドの設定

1. Call WRIKE_GET_ALL_CUSTOM_FIELDS to get definitions
2. Find field by name, extract id and type
3. Format value according to type (text, dropdown, number, date)
4. Include as {id: 'FIELD_ID', value: 'VALUE'} in customFields array

タスクの割り当て

1. Call WRIKE_GET_CONTACTS to find user IDs
2. Use user IDs in responsibles array when creating tasks
3. Or use addResponsibles/removeResponsibles when modifying tasks

ページネーション

• FETCH_ALL_TASKS：page_size（最大 100）を使用し、さらに結果があるか確認します
• GET_FOLDERS：descendants=false で pageSize を設定した場合は、nextPageToken を使用します
• LIST_TASK_BLUEPRINTS：next_page_token と page_size（デフォルトは 100）を使用します

既知の注意点

ID 形式：

• Wrike の ID は、不透明な英数字の文字列です（例：'IEAGTXR7I4IHGABC'）
• タスク ID、フォルダー ID、スペース ID、ユーザー ID はすべてこの形式です
• カスタムフィールド ID も同じ形式です
• ID を推測してはいけません。必ず一覧表示または検索操作で確認してください

権限：

• 操作はユーザーのロールと共有設定によって異なります
• 共有フォルダーやタスクを表示できるのは、共有されているユーザーのみです
• 管理者操作には適切なロールが必要です
• 一部の機能（カスタムステータス、請求タイプ）はプランによって異なります

削除時の注意：

• DELETE_FOLDER はすべての内容を完全に削除します
• DELETE_SPACE はスペース全体とその内容を削除します
• 代わりに MODIFY_FOLDER を使って、ごみ箱に移動することを検討してください
• MODIFY_FOLDER で restore=true を指定すると、ごみ箱から復元できます

日付の処理：

• 日付には 'yyyy-MM-dd' 形式を使用します
• 日時には 'yyyy-MM-ddTHH:mm:ssZ' 形式、またはタイムゾーンオフセット付きの形式を使用します
• タスクの日付には、タイプ（'Planned'、'Actual'）、開始日、期限、期間が含まれます
• 期間の単位は分です

クイックリファレンス

タスク	ツールのスラッグ	主なパラメーター
タスクを作成	WRIKE_CREATE_TASK	folderId, title, responsibles, status
タスクを変更	WRIKE_MODIFY_TASK	taskId, title, status, addResponsibles
ID でタスクを取得	WRIKE_GET_TASK_BY_ID	taskId
すべてのタスクを取得	WRIKE_FETCH_ALL_TASKS	status, dueDate, page_size
フォルダーを取得	WRIKE_GET_FOLDERS	project, descendants
フォルダーを作成	WRIKE_CREATE_FOLDER	folderId, title
フォルダーを変更	WRIKE_MODIFY_FOLDER	folderId, title, addShareds
フォルダーを削除	WRIKE_DELETE_FOLDER	folderId
サブフォルダーを一覧表示	WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID	folderId
カスタムフィールドを取得	WRIKE_GET_ALL_CUSTOM_FIELDS	(none)
ブループリントを一覧表示	WRIKE_LIST_TASK_BLUEPRINTS	limit, page_size
ブループリントを起動	WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC	task_blueprint_id, title, parent_id
スペースを取得	WRIKE_GET_SPACE	spaceId
スペースを削除	WRIKE_DELETE_SPACE	spaceId
連絡先を取得	WRIKE_GET_CONTACTS	(none)
ユーザーを招待	WRIKE_CREATE_INVITATION	email, role

---

Composio 提供