claude-office-skills/clickup-automation

clickup-automation は何をしますか？

ClickUpのワークスペース管理、タスクワークフロー、タイムトラッキング、チーム生産性を自動化します。

概要

このスキルを使用すると、ClickUp API を介してタスク、リスト、フォルダ、スペース、チームを管理できます。主な機能は以下の通りです。

• タスク管理: タスクの作成、更新、削除、検索、ステータス変更
• リスト管理: リストの作成、タスクの一覧表示
• フォルダ管理: フォルダの作成と管理
• スペース管理: スペースの作成と管理
• チーム管理: チームの一覧表示
• コメント: タスクへのコメント追加
• タイムトラッキング: タイムエントリの作成と管理
• タグ: タグの追加と削除
• 依存関係: タスク間の依存関係管理
• カスタムフィールド: カスタムフィールド値の設定

セットアップ

1. ClickUpで 個人設定 > アプリ > APIトークン から API トークンを作成します。
2. 環境変数 CLICKUP_API_TOKEN にトークンを設定します。
3. 環境変数 CLICKUP_TEAM_ID にデフォルトのチームIDを設定します（オプション）。

使用方法

タスクの作成

新しいタスクを作成して：「バグ修正」をリスト「開発」に追加して、優先度を「高」に設定して

タスクの検索

「ログイン」という単語を含むタスクをすべて検索して

タイムトラッキング

タスク「ABC-123」に2時間のタイムエントリを追加して、説明は「コードレビュー」

利用可能なツール

clickup_tasks

タスクの作成、更新、削除、検索を行います。

• operation: create | update | delete | search | get
• list_id: タスクを操作するリストのID（必須）
• name: タスク名
• description: タスクの説明
• status: ステータス（例："to do", "in progress", "done"）
• priority: 優先度（1-4、1=緊急、2=高、3=通常、4=低）
• assignees: 担当者のユーザーID配列
• tags: タグ名の配列
• due_date: 期日（Unix ミリ秒）
• start_date: 開始日（Unix ミリ秒）
• parent: 親タスクのID

clickup_lists

リストの作成とタスクの一覧表示を行います。

• operation: create | get_tasks
• folder_id: フォルダID（フォルダ内にリストを作成する場合）
• space_id: スペースID（スペース直下にリストを作成する場合）
• name: リスト名
• content: リストの説明
• due_date: 期日（Unix ミリ秒）
• priority: 優先度（1-4）
• assignee: 担当者のユーザーID
• status: ステータス

clickup_folders

フォルダの作成と管理を行います。

• operation: create
• space_id: スペースID
• name: フォルダ名

clickup_spaces

スペースの作成と管理を行います。

• operation: create | get
• team_id: チームID
• name: スペース名
• multiple_assignees: 複数担当者を許可するかどうか
• features: スペースの機能設定

clickup_teams

チームの一覧表示を行います。

• operation: list

clickup_comments

タスクにコメントを追加します。

• operation: create
• task_id: タスクID
• comment_text: コメントテキスト
• assignee: 通知する担当者のユーザーID（オプション）
• notify_all: 全員に通知するかどうか（オプション）

clickup_time_tracking

タイムエントリの作成と管理を行います。

• operation: create | get | update | delete
• task_id: タスクID
• start: 開始時間（Unix ミリ秒）
• duration: ミリ秒単位の時間
• description: 時間の説明

clickup_tags

タスクにタグを追加または削除します。

• operation: add | remove
• task_id: タスクID
• tag_name: タグ名

clickup_dependencies

タスク間の依存関係を管理します。

• operation: create | delete
• task_id: 依存関係を持つタスクID
• depends_on: 依存先のタスクID
• dependency_type: 依存関係のタイプ

clickup_custom_fields

カスタムフィールドの値を設定します。

• operation: set_value
• task_id: タスクID
• field_id: カスタムフィールドID
• value: 設定する値

よくある質問

APIトークンはどこで取得できますか？

ClickUp 設定 > アプリ > APIトークン で生成できます。

タスクIDはどこで確認できますか？

タスクのURL（例: https://app.clickup.com/t/123456789）の末尾がタスクIDです。

リストIDはどこで確認できますか？

リストのURL（例: https://app.clickup.com/1234567/v/l/8-123456789-1）のl/の後ろの部分がリストIDです。

制限事項

• このスキルは ClickUp API v2 を使用しています。
• 一部の操作は API レート制限の対象となります。
• チーム管理機能は読み取り専用です。

サポート

問題が発生した場合は、以下の点を確認してください。

1. APIトークンが正しく設定されているか確認する
2. 操作に必要な権限があるか確認する
3. ClickUp API のステータスを確認する