clickup-automation

Rube MCP による ClickUp の自動化

Composio の ClickUp ツールキットを通じて、タスクの作成や更新、ワークスペース階層の移動、コメント、チームメンバーの管理など、ClickUp のプロジェクト管理ワークフローを自動化します。

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

前提条件

• Rube MCP に接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を使用して、ツールキット clickup で ClickUp に接続されている必要があります
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

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

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

主なワークフロー

1. タスクの作成と管理

使用する場面：ユーザーが ClickUp リスト内のタスクやサブタスクの作成、タスクプロパティの更新、またはタスクの一覧表示を希望する場合。

ツールの呼び出し順序：

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - ワークスペース／チーム ID を取得します［前提条件］
2. CLICKUP_GET_SPACES - ワークスペース内のスペースを一覧表示します［前提条件］
3. CLICKUP_GET_FOLDERS - スペース内のフォルダーを一覧表示します［前提条件］
4. CLICKUP_GET_FOLDERLESS_LISTS - フォルダー内にないリストを取得します［任意］
5. CLICKUP_GET_LIST - リストを検証し、利用可能なステータスを確認します［前提条件］
6. CLICKUP_CREATE_TASK - 対象のリストにタスクを作成します［必須］
7. CLICKUP_CREATE_TASK（parent を指定） - 親タスクの下にサブタスクを作成します［任意］
8. CLICKUP_UPDATE_TASK - タスクのステータス、担当者、日付、優先度を変更します［任意］
9. CLICKUP_GET_TASK - タスクの詳細情報を取得します［任意］
10. CLICKUP_GET_TASKS - フィルターを指定して、リスト内のすべてのタスクを一覧表示します［任意］
11. CLICKUP_DELETE_TASK - タスクを完全に削除します［任意］

CLICKUP_CREATE_TASK の主なパラメーター：

• list_id：対象のリスト ID（整数、必須）
• name：タスク名（文字列、必須）
• description：タスクの詳細な説明
• status：対象リストに設定されているステータス名と完全に一致する必要があります（大文字と小文字を区別）
• priority：1（緊急）、2（高）、3（通常）、4（低）
• assignees：ユーザー ID の配列（整数）
• due_date：Unix タイムスタンプ（ミリ秒）
• parent：サブタスクを作成する際に指定する親タスク ID（文字列）
• tags：タグ名の文字列の配列
• time_estimate：推定時間（ミリ秒）

注意事項：

• status は大文字と小文字を区別し、リスト内の既存のステータスと一致する必要があります。利用可能なステータスを確認するには CLICKUP_GET_LIST を使用してください
• due_date と start_date は秒ではなく、Unix タイムスタンプのミリ秒です
• サブタスクの parent は、同じリスト内のタスクである必要があります（別のサブタスクは指定できません）
• notify_all を有効にするとウォッチャーに通知されます。一括操作では false に設定してください
• リトライすると重複が作成される場合があります。再作成を避けるため、作成したタスク ID を記録してください
• マイルストーンの custom_item_id（ID 1）には、ワークスペースのプランごとの上限が適用されます

2. ワークスペースの階層を参照する

使用する場面：ユーザーが ClickUp のワークスペース構造（Workspaces > Spaces > Folders > Lists）を参照または管理したい場合。

ツールの順序：

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - アクセス可能なすべてのワークスペースを一覧表示します［必須］
2. CLICKUP_GET_SPACES - ワークスペース内のスペースを一覧表示します［必須］
3. CLICKUP_GET_SPACE - 特定のスペースの詳細を取得します［任意］
4. CLICKUP_GET_FOLDERS - スペース内のフォルダーを一覧表示します［必須］
5. CLICKUP_GET_FOLDER - 特定のフォルダーの詳細を取得します［任意］
6. CLICKUP_CREATE_FOLDER - スペースに新しいフォルダーを作成します［任意］
7. CLICKUP_GET_FOLDERLESS_LISTS - どのフォルダーにも属さないリストを一覧表示します［必須］
8. CLICKUP_GET_LIST - ステータスやカスタムフィールドを含むリストの詳細を取得します［任意］

主なパラメーター：

• team_id：GET_AUTHORIZED_TEAMS_WORKSPACES で取得したワークスペース ID（スペースには必須）
• space_id：スペース ID（フォルダーとフォルダーに属さないリストには必須）
• folder_id：フォルダー ID（GET_FOLDER には必須）
• list_id：リスト ID（GET_LIST には必須）
• archived：アーカイブ済み／アクティブな項目を絞り込むブール値

注意点：

• ClickUp の階層は次のとおりです：Workspace (Team) > Space > Folder > List > Task
• リストはスペース直下（フォルダーに属さない状態）またはフォルダー内に作成できます
• フォルダー内にないリストを見つけるには CLICKUP_GET_FOLDERLESS_LISTS を使用する必要があります。CLICKUP_GET_FOLDERS で返されるのはフォルダーのみです
• ClickUp API の team_id はワークスペース ID を指し、ユーザーグループではありません

3. タスクにコメントを追加する

使用する場面：ユーザーがタスクにコメントを追加したい場合、既存のコメントを確認したい場合、またはタスクのコメントスレッドを管理したい場合。

ツールの順序：

1. CLICKUP_GET_TASK - タスクの存在を確認し、task_id を取得します［前提条件］
2. CLICKUP_CREATE_TASK_COMMENT - タスクに新しいコメントを追加します［必須］
3. CLICKUP_GET_TASK_COMMENTS - タスクの既存コメントを一覧表示します［任意］
4. CLICKUP_UPDATE_COMMENT - コメントのテキスト、担当者、または解決ステータスを編集します［任意］

CLICKUP_CREATE_TASK_COMMENT の主なパラメーター：

• task_id：タスク ID 文字列（必須）
• comment_text：ClickUp の書式設定に対応したコメント内容（必須）
• assignee：コメントの担当者として指定するユーザー ID（必須）
• notify_all：ウォッチャーへの通知を指定する true/false（必須）

CLICKUP_GET_TASK_COMMENTS の主なパラメーター：

• task_id：タスク ID 文字列（必須）
• start / start_id：古いコメントを取得するためのページネーション（1 ページあたり最大 25 件）

注意点：

• CLICKUP_CREATE_TASK_COMMENT には task_id、comment_text、assignee、notify_all の4つすべてが必要です
• コメントの assignee は、タスクではなくコメントをそのユーザーに割り当てます
• コメントは1ページあたり25件でページ分割されます。古いページを取得するには start（Unix ms）と start_id を使用します
• CLICKUP_UPDATE_COMMENT には comment_id、comment_text、assignee、resolved の4つすべてが必要です

4. チームメンバーと割り当てを管理する

使用する場面：ユーザーがワークスペースのメンバーを確認したい場合、ライセンスの利用状況を確認したい場合、またはユーザーの詳細を調べたい場合。

ツールの順序：

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - ワークスペースを一覧表示して team_id を取得します［必須］
2. CLICKUP_GET_WORKSPACE_SEATS - ライセンスの利用状況（メンバーとゲストの内訳）を確認します［必須］
3. CLICKUP_GET_TEAMS - ワークスペース内のユーザーグループを一覧表示します［任意］
4. CLICKUP_GET_USER - 特定のユーザーの詳細を取得します（Enterprise のみ）［任意］
5. CLICKUP_GET_CUSTOM_ROLES - カスタム権限ロールを一覧表示します［任意］

主なパラメーター：

• team_id：ワークスペース ID（すべてのチーム操作で必須）
• user_id：GET_USER で指定する特定のユーザー ID
• group_ids：チームを絞り込むための、カンマ区切りのグループ ID

注意点：

• CLICKUP_GET_WORKSPACE_SEATS が返すのはライセンス数であり、メンバーの詳細ではありません。メンバーとゲストを区別してください
• CLICKUP_GET_TEAMS が返すのはユーザーグループであり、ワークスペースのメンバーではありません。グループが空でもメンバーがいないとは限りません
• CLICKUP_GET_USER は ClickUp Enterprise Plan でのみ利用できます
• 複数のワークスペースを利用している場合は、各ワークスペースのライセンス情報を繰り返し取得する必要があります

5. タスクのフィルタリングと検索

使用するタイミング：ステータス、担当者、日付、タグ、カスタムフィールドなどの条件を指定してタスクを検索したい場合です。

ツールの順序：

1. CLICKUP_GET_TASKS - 複数の条件を指定してリスト内のタスクをフィルタリングします［必須］
2. CLICKUP_GET_TASK - 個々のタスクの詳細を取得します［任意］

CLICKUP_GET_TASKS の主なパラメーター：

• list_id：リスト ID（整数、必須）
• statuses：フィルタリング対象のステータス文字列の配列
• assignees：ユーザー ID 文字列の配列
• tags：タグ名文字列の配列
• due_date_gt / due_date_lt：日付範囲を指定する Unix タイムスタンプ（ミリ秒）
• include_closed：クローズ済みタスクを含めるかどうかを指定するブール値
• subtasks：サブタスクを含めるかどうかを指定するブール値
• order_by：「id」、「created」、「updated」、または「due_date」
• page：0 から始まるページ番号（1 ページあたり最大 100 件のタスク）

注意点：

• list_id とホームリストが一致するタスクのみが返されます。サブリスト内のタスクは含まれません
• 日付フィルターには Unix タイムスタンプ（ミリ秒）を使用します
• ステータス文字列は完全一致する必要があります。スペースには URL エンコーディングを使用します（例：「to%20do」）
• ページ番号は 0 から始まり、各ページには最大 100 件のタスクが返されます
• custom_fields フィルターには、オブジェクトではなく JSON 文字列の配列を指定します

よくあるパターン

ID の解決

名前は常に階層をたどって ID に解決します：

• ワークスペース名 -> team_id：CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES を使用し、名前で照合します
• Space 名 -> space_id：team_id を指定して CLICKUP_GET_SPACES を使用します
• フォルダー名 -> folder_id：space_id を指定して CLICKUP_GET_FOLDERS を使用します
• リスト名 -> list_id：フォルダーをたどるか、CLICKUP_GET_FOLDERLESS_LISTS を使用します
• タスク名 -> task_id：list_id を指定して CLICKUP_GET_TASKS を使用し、名前で照合します

ページネーション

• CLICKUP_GET_TASKS：page を 0 から指定するページベース方式で、1 ページあたり最大 100 件のタスクを取得します
• CLICKUP_GET_TASK_COMMENTS：カーソルベースのページネーションには start（Unix ミリ秒）と start_id を使用し、1 ページあたり最大 25 件を取得します
• レスポンスの件数がページサイズを下回るまで取得を続けます

既知の注意点

ID の形式

• ワークスペース／チーム ID は大きな整数です
• Space、フォルダー、リストの ID は整数です
• タスク ID は英数字の文字列です（例：「9hz」、「abc123」）
• ユーザー ID は整数です
• コメント ID は整数です

レート制限

• ClickUp にはレート制限があり、タスクを一括作成すると 429 レスポンスが発生することがあります
• Retry-After ヘッダーがある場合は、その値に従ってください
• 一括操作では notify_all=false を設定して、通知の負荷を軽減してください

パラメーターに関する注意点

• API の team_id はユーザーグループではなく、ワークスペース ID を意味します
• タスクの status は大文字と小文字を区別し、リストごとに異なります
• 日付は Unix タイムスタンプ（ミリ秒）です（秒の値に 1000 を掛けます）
• priority は整数の 1～4 です（1=緊急、4=低）。文字列ではありません
• CLICKUP_CREATE_TASK_COMMENT では、assignee と notify_all が必須として指定されています
• タスクの説明を消去するには、CLICKUP_UPDATE_TASK に単一のスペース " " を渡します

階層ルール

• サブタスクの親は、それ自体がサブタスクであってはなりません
• サブタスクの親は同じリスト内にある必要があります
• リストはフォルダーなし（Space 内に直接配置）またはフォルダー内に配置できます
• CLICKUP_CREATE_TASK はサブアイテムボードに対応していません

Quick Reference

Task	Tool Slug	Key Params
List workspaces	CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES	(none)
List spaces	CLICKUP_GET_SPACES	team_id
Get space details	CLICKUP_GET_SPACE	space_id
List folders	CLICKUP_GET_FOLDERS	space_id
Get folder details	CLICKUP_GET_FOLDER	folder_id
Create folder	CLICKUP_CREATE_FOLDER	space_id, name
Folderless lists	CLICKUP_GET_FOLDERLESS_LISTS	space_id
Get list details	CLICKUP_GET_LIST	list_id
Create task	CLICKUP_CREATE_TASK	list_id, name, status, assignees
Update task	CLICKUP_UPDATE_TASK	task_id, status, priority
Get task	CLICKUP_GET_TASK	task_id, include_subtasks
List tasks	CLICKUP_GET_TASKS	list_id, statuses, page
Delete task	CLICKUP_DELETE_TASK	task_id
Add comment	CLICKUP_CREATE_TASK_COMMENT	task_id, comment_text, assignee
List comments	CLICKUP_GET_TASK_COMMENTS	task_id, start, start_id
Update comment	CLICKUP_UPDATE_COMMENT	comment_id, comment_text, resolved
Workspace seats	CLICKUP_GET_WORKSPACE_SEATS	team_id
List user groups	CLICKUP_GET_TEAMS	team_id
Get user details	CLICKUP_GET_USER	team_id, user_id
Custom roles	CLICKUP_GET_CUSTOM_ROLES	team_id

---

Powered by Composio