ClickUpタスクをAIアプリケーションと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIエージェントは標準化されたプロトコルを介してClickUpタスク、スペース、リスト、フォルダーと対話できるようになります。
🚀**ステータス更新:**完全な時間追跡サポートとドキュメント管理機能を備えた v0.7.2 が利用可能になりました。
設定
資格情報を取得します:
ClickUp設定からのClickUp APIキー
ClickUpワークスペースURLからのチームID
ホスト型インストール（Webhook を送信）または NPX インストール（ローカル パスにダウンロードして依存関係をインストール）のいずれかを選択します。
自然言語を使用してワークスペースを管理しましょう。
Related MCP server: ClickUp MCP Server
Smithery のインストール (クイック スタート)
サーバーはSmitheryでホストされています。そこでは、利用可能なツールをプレビューしたり、特定のクライアントアプリで実行するコマンドをコピーしたりできます。
NPXのインストール
クライアントの MCP 設定 JSON ファイルに次のエントリを追加します。
または、次の npx コマンドを使用します。
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
注意: 「DOCUMENT_SUPPORT」に「true」を渡さない場合、デフォルトは false となり、ドキュメント サポートはアクティブになりません。
さらに、 DISABLED_TOOLS環境変数または--env DISABLED_TOOLS引数を使用して、特定のツールを無効にすることもできます。無効にするツール名をカンマ区切りのリストで指定してください（例： create_task,delete_task ）。
ツールの数やコンテキストの制限に問題がある場合は、不要なツールを無効にしてください。
SSEサポートで実行
次の環境変数を設定することにより、サーバーを SSE (Server-Sent Events) モードで実行できます。
またはコマンドラインから:
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000
Docker-compose の例
特徴
📝 タスク管理 | 🏷️ タグ管理 |
• タスクの作成、更新、削除• タスクをどこからでも移動および複製• 単一操作と一括操作のサポート• 自然言語で開始日/期限を設定• サブタスクの作成と管理• コメントと添付ファイルの追加 | • スペースタグの作成、更新、削除• タスクへのタグの追加と削除• 自然言語のカラーコマンドの使用• 前景色の自動コントラスト• すべてのスペースタグの表示• ワークスペース全体でのタグベースのタスク整理 |
⏱️ 時間追跡 | 🌳 ワークスペースの整理 |
• タスクの時間エントリの表示• タスクの時間追跡の開始/停止• 手動時間エントリの追加• 時間エントリの削除• 現在実行中のタイマーの表示• 請求可能な時間と請求不可能な時間の追跡 | • スペース、フォルダ、リストのナビゲーション• フォルダの作成と管理• スペース内のリストの整理• フォルダ内のリストの作成• ワークスペース階層の表示• 効率的なパスナビゲーション |
📄 ドキュメント管理 | 👥 メンバー管理 |
• ワークスペース全体でのドキュメント一覧表示• ドキュメントページの一覧表示• ドキュメントページの詳細表示• ドキュメントの作成• ドキュメントページの更新（先頭と末尾への追加） | • ワークスペースのメンバーを名前またはメールアドレスで検索• タスクの担当者を解決• メンバーの詳細と権限を表示• 作成時にユーザーにタスクを割り当て• ユーザーID、メールアドレス、またはユーザー名をサポート• チーム全体のユーザー管理 |
⚡ 統合機能 | |
• グローバル名またはIDベースの検索• 大文字と小文字を区別しないマッチング• Markdownフォーマットのサポート• 組み込みのレート制限• エラー処理と検証• 包括的なAPIカバレッジ |
利用可能なツール
道具 | 説明 | 必須パラメータ |
ワークスペース構造を取得する | なし | |
タスクを作成する |
、(
/
) | |
複数のタスクを作成する |
| |
タスクの変更 |
/
| |
複数のタスクを更新する | IDまたは名前を持つ
| |
リストからタスクを取得する |
/
| |
単一のタスクの詳細を取得する |
/
（スマートな曖昧さ回避付き） | |
フィルタリングしてタスクを取得する | 少なくとも 1 つのフィルター (タグ、list_ids、space_ids など) | |
タスクに関するコメントを取得する |
/
| |
タスクにコメントを追加する |
、(
/(
+
)) | |
タスクにファイルを添付する |
/
、(
または
) | |
タスクを削除 |
/
| |
複数のタスクを削除する | IDまたは名前を持つ
| |
タスクを移動 |
/
、
/
| |
複数のタスクを移動する | IDまたは名前を持つ
、ターゲットリスト | |
タスクをコピー |
/
、
/
| |
スペースでリストを作成する |
、
/
| |
フォルダを作成 |
、
/
| |
フォルダにリストを作成 |
、
/
| |
フォルダの詳細を取得する |
/
| |
フォルダのプロパティを更新する |
/
| |
フォルダを削除 |
/
| |
リストの詳細を取得する |
/
| |
リストのプロパティを更新する |
/
| |
リストを削除 |
/
| |
スペースタグを取得する |
/
| |
タグを作成 |
、
/
| |
タグを更新 |
、
/
| |
タグを削除 |
、
/
| |
タスクにタグを追加する |
、
/(
+
) | |
タスクからタグを削除する |
、
/(
+
) | |
タスクの時間エントリを取得する |
/
| |
タスクの時間追跡を開始する |
/
| |
現在の時間追跡を停止 | なし | |
タスクに手動で時間を入力する |
/
、
、
| |
時間エントリを削除する |
| |
現在実行中のタイマーを取得する | なし | |
ワークスペースのメンバー全員を取得する | なし | |
名前またはメールアドレスでメンバーを検索 |
| |
メンバー名をIDに解決する |
| |
ドキュメントを作成する |
、
、
/
、
、
| |
ドキュメントを取得する |
/
| |
ドキュメントの一覧 |
、
/
/
/
済み /
/
/
/
| |
ドキュメントページの一覧 |
/
| |
ドキュメントページを取得する |
/
、
| |
ドキュメントページを作成する |
/
、
/
/
、
/
| |
ドキュメントページを更新する |
/
ID、
/
、
/ コンテンツ
/
|
オプションのパラメータと高度な使用法については、完全なドキュメントを参照してください。
会員管理ツール
タスク作成時に、 assigneesパラメータを使ってユーザーを割り当てることができるようになりました。このパラメータは、ユーザーID、メールアドレス、またはユーザー名の配列を受け入れます。
メンバー管理ツールは、必要に応じてユーザー参照を解決するのに役立ちます。
プロンプト
まだ実装されておらず、すべてのクライアントアプリでサポートされているわけではありません。ワークフローに最も役立つと思われるPromptの実装機能をリクエストしてください（具体的な内容は問いません）。例：
エラー処理
サーバーは、次の場合に明確なエラー メッセージを提供します。
必要なパラメータが不足しています
無効なIDまたは名前
アイテムが見つかりません
権限の問題
APIエラー
レート制限
LOG_LEVEL環境変数を指定することで、サーバーログの詳細度を制御できます。有効な値は、 trace 、 debug 、 info 、 warn 、 error （デフォルト）です。これはコマンドラインでも指定できます（例： --env LOG_LEVEL=info ）。
開発者をサポートする
このサーバーをご利用の際に、ツールのレスポンスにこのリポジトリへのリンクを含む小さなスポンサーメッセージが表示されることがあります。プロジェクトへのご支援をお待ちしております。このプロジェクトが役に立つと思われましたら、ぜひご支援ください。
謝辞
この統合を可能にした優れた API とサービスについて、 ClickUpに特に感謝します。
貢献
貢献を歓迎します！詳細については貢献ガイドをご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
免責事項
本ソフトウェアはサードパーティのAPIを利用しており、サードパーティが所有する商標またはブランドを参照する場合があります。これらのAPIまたは参照の使用は、各企業との提携または推奨を意味するものではありません。すべての商標およびブランド名はそれぞれの所有者の財産です。本プロジェクトは独立した作品であり、言及されているいかなるサードパーティ企業とも公式に提携またはスポンサー契約を結んでいません。
Appeared in Searches
- A method or tool for managing ClickUp task list custom fields with read and write update capabilities
- Automating Task Assignment Based on Priority with Reshuffling Capabilities
- Tools and platforms for task management
- A tool for planning and managing software projects
- A server for software engineers that integrates with Jira and Slack