mcpField
C
clickup-automation

clickup-automation

github.com/davepoon生産性3.7k129 回インストール2 日前に更新
リポジトリ

clickup-automation について

clickup-automationは、Rube MCP上のComposioツールキットを通じてClickUpのプロジェクト管理を自動化するスキルです。タスクやコメントの操作、ワークスペースの確認、チームメンバー管理に対応します。

主な機能

  1. 01タスクの作成、更新、検索
  2. 02ワークスペース、スペース、フォルダー、リストの確認
  3. 03タスクコメントの追加と管理
  4. 04ワークスペースの席数とユーザーグループの確認

活用シーン

  1. 01リスト内でタスクやサブタスクを作成
  2. 02ステータス、担当者、日付によるタスクの絞り込み
  3. 03タスクコメントの追加や確認
  4. 04ワークスペース構成と席数の確認

MCP 対応

Rube MCPを介してComposioのClickUpツールキットを利用します。ClickUp接続を有効にし、操作前に最新のツールスキーマを取得する必要があります。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill clickup-automation

インストール後、Claude Code で/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

TaskTool SlugKey Params
List workspacesCLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES(none)
List spacesCLICKUP_GET_SPACESteam_id
Get space detailsCLICKUP_GET_SPACEspace_id
List foldersCLICKUP_GET_FOLDERSspace_id
Get folder detailsCLICKUP_GET_FOLDERfolder_id
Create folderCLICKUP_CREATE_FOLDERspace_id, name
Folderless listsCLICKUP_GET_FOLDERLESS_LISTSspace_id
Get list detailsCLICKUP_GET_LISTlist_id
Create taskCLICKUP_CREATE_TASKlist_id, name, status, assignees
Update taskCLICKUP_UPDATE_TASKtask_id, status, priority
Get taskCLICKUP_GET_TASKtask_id, include_subtasks
List tasksCLICKUP_GET_TASKSlist_id, statuses, page
Delete taskCLICKUP_DELETE_TASKtask_id
Add commentCLICKUP_CREATE_TASK_COMMENTtask_id, comment_text, assignee
List commentsCLICKUP_GET_TASK_COMMENTStask_id, start, start_id
Update commentCLICKUP_UPDATE_COMMENTcomment_id, comment_text, resolved
Workspace seatsCLICKUP_GET_WORKSPACE_SEATSteam_id
List user groupsCLICKUP_GET_TEAMSteam_id
Get user detailsCLICKUP_GET_USERteam_id, user_id
Custom rolesCLICKUP_GET_CUSTOM_ROLESteam_id

Powered by Composio

コメント

Markdown 対応