remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Allows AI agents to interact with ClickUp tasks, spaces, lists, and folders, including creating, updating, deleting, moving and duplicating tasks, as well as managing workspace organization through a standardized Model Context Protocol (MCP) server.
ClickUpタスクをAIアプリケーションと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIエージェントは標準化されたプロトコルを介してClickUpタスク、スペース、リスト、フォルダーと対話できるようになります。
🚧ステータス更新: v0.6.9 のロールアウトでは、スマートな曖昧性解消機能を備えたグローバルタスク検索、自然言語表現を使用したタスクの開始日サポート、自然言語タグカラーコマンドを含む完全なタグサポート、サブタスクサポート、カスタム ID サポート、およびログの修正が追加されます。
設定
- 資格情報を取得します:
- ClickUp設定からのClickUp APIキー
- ClickUp ワークスペース URL からのチーム ID
- ホスト型インストール（Webhook を送信）または NPX インストール（ローカル パスにダウンロードして依存関係をインストール）のいずれかを選択します。
- 自然言語を使用してワークスペースを管理しましょう。
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
特徴
| 📝 タスク管理 | 🏷️ タグ管理 |
|---|---|
| • タスクの作成、更新、削除• タスクをどこからでも移動および複製• 単一操作と一括操作のサポート• 自然言語で開始日/期限を設定• サブタスクの作成と管理• コメントと添付ファイルの追加 | • スペースタグの作成、更新、削除• タスクへのタグの追加と削除• 自然言語のカラーコマンドの使用• 前景色の自動コントラスト• すべてのスペースタグの表示• ワークスペース全体でのタグベースのタスク整理 |
| ⏱️時間追跡 | 🌳ワークスペースの整理 |
| • タスクの時間エントリの表示• タスクの時間追跡の開始/停止• 手動時間エントリの追加• 時間エントリの削除• 現在実行中のタイマーの表示• 請求可能な時間と請求不可能な時間の追跡 | • スペース、フォルダ、リストのナビゲーション• フォルダの作成と管理• スペース内のリストの整理• フォルダ内のリストの作成• ワークスペース階層の表示• 効率的なパスナビゲーション |
| ⚡統合機能 | |
| • グローバル名またはIDベースの検索• 大文字と小文字を区別しないマッチング• Markdownフォーマットのサポート• 組み込みのレート制限• エラー処理と検証• 包括的なAPIカバレッジ |
利用可能なツール
| 道具 | 説明 | 必須パラメータ |
|---|---|---|
| ワークスペース階層を取得する | ワークスペース構造を取得する | なし |
| タスク作成 | タスクを作成する | name 、( listId / listName ) |
| 一括タスク作成 | 複数のタスクを作成する | tasks[] |
| 更新タスク | タスクの変更 | taskId / taskName |
| 一括タスクの更新 | 複数のタスクを更新する | IDまたは名前を持つtasks[] |
| タスクを取得する | リストからタスクを取得する | listId / listName |
| タスク取得 | 単一のタスクの詳細を取得する | taskId / taskName （スマートな曖昧さ回避付き） |
| ワークスペースタスクを取得する | フィルタリングしてタスクを取得する | 少なくとも 1 つのフィルター (タグ、list_ids、space_ids など) |
| タスクコメントを取得する | タスクに関するコメントを取得する | taskId / taskName |
| タスクコメント作成 | タスクにコメントを追加する | commentText 、( taskId /( taskName + listName )) |
| タスクファイルの添付 | タスクにファイルを添付する | taskId / taskName 、( file_dataまたはfile_url ) |
| タスクの削除 | タスクを削除 | taskId / taskName |
| 一括タスクの削除 | 複数のタスクを削除する | IDまたは名前を持つtasks[] |
| タスクの移動 | タスクを移動 | taskId / taskName 、 listId / listName |
| 一括タスクの移動 | 複数のタスクを移動する | IDまたは名前を持つtasks[] 、ターゲットリスト |
| 重複タスク | タスクをコピー | taskId / taskName 、 listId / listName |
| リストを作成 | スペースにリストを作成する | name 、 spaceId / spaceName |
| フォルダの作成 | フォルダを作成 | name 、 spaceId / spaceName |
| フォルダー内にリストを作成する | フォルダにリストを作成 | name 、 folderId / folderName |
| フォルダを取得する | フォルダの詳細を取得する | folderId / folderName |
| 更新フォルダ | フォルダのプロパティを更新する | folderId / folderName |
| フォルダの削除 | フォルダを削除 | folderId / folderName |
| get_list | リストの詳細を取得する | listId / listName |
| 更新リスト | リストのプロパティを更新する | listId / listName |
| 削除リスト | リストを削除 | listId / listName |
| スペースタグを取得する | スペースタグを取得する | spaceId / spaceName |
| スペースタグを作成する | タグを作成 | tagName 、 spaceId / spaceName |
| スペースタグの更新 | タグを更新 | tagName 、 spaceId / spaceName |
| スペースタグの削除 | タグを削除 | tagName 、 spaceId / spaceName |
| タスクにタグを追加する | タスクにタグを追加する | tagName 、 taskId /( taskName + listName ) |
| タスクからタグを削除する | タスクからタグを削除する | tagName 、 taskId /( taskName + listName ) |
| get_task_time_entries | タスクの時間エントリを取得する | taskId / taskName |
| 開始時間追跡 | タスクの時間追跡を開始する | taskId / taskName |
| 停止時間追跡 | 現在の時間追跡を停止 | なし |
| 時間エントリの追加 | タスクに手動で時間を入力する | taskId / taskName 、 start 、 duration |
| タイムエントリの削除 | 時間エントリを削除する | timeEntryId |
| get_current_time_entry | 現在実行中のタイマーを取得する | なし |
オプションのパラメータと高度な使用法については、完全なドキュメントを参照してください。
プロンプト
まだ実装されておらず、すべてのクライアントアプリでサポートされているわけではありません。ワークフローに最も役立つと思われるPromptの実装機能をリクエストしてください（具体的な内容は問いません）。例：
| プロンプト | 目的 | 特徴 |
|---|---|---|
| タスクの要約 | タスクの概要 | ステータスの概要、優先順位、関係 |
| 優先順位を分析する | 優先度最適化 | 分布解析、配列決定 |
| 説明を生成する | タスクの説明の作成 | 目的、基準、依存関係 |
エラー処理
サーバーは、次の場合に明確なエラー メッセージを提供します。
- 必要なパラメータが不足しています
- 無効なIDまたは名前
- アイテムが見つかりません
- 権限の問題
- APIエラー
- レート制限
LOG_LEVEL環境変数を指定することで、サーバーログの詳細度を制御できます。有効な値は、 trace 、 debug 、 info 、 warn 、 error （デフォルト）です。これはコマンドラインでも指定できます（例： --env LOG_LEVEL=info ）。
開発者をサポートする
このサーバーをご利用の際に、ツールのレスポンスにこのリポジトリへのリンクを含む小さなスポンサーメッセージが表示されることがあります。プロジェクトへのご支援をお待ちしております。このプロジェクトが役に立つと思われましたら、ぜひご支援ください。
謝辞
この統合を可能にした優れた API とサービスについて、 ClickUpに特に感謝します。
貢献
貢献を歓迎します！詳細については貢献ガイドをご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
免責事項
本ソフトウェアはサードパーティのAPIを利用しており、サードパーティが所有する商標またはブランドを参照する場合があります。これらのAPIまたは参照の使用は、各企業との提携または推奨を意味するものではありません。すべての商標およびブランド名はそれぞれの所有者の財産です。本プロジェクトは独立した作品であり、言及されているいかなるサードパーティ企業とも公式に提携またはスポンサー契約を結んでいません。
You must be authenticated.
Tools
ClickUp タスクとの AI 統合を可能にし、標準化されたプロトコルを通じてリソース管理、タスク操作、ワークスペース編成、AI を活用したタスク推奨をサポートします。
- Smithery Installation (Quick Start)
- NPX Installation
- Features
- Available Tools
- Prompts
- Error Handling
- Support the Developer
- Acknowledgements
- Contributing
- License
- Disclaimer