A
securityA
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
56
7
TypeScript
MIT License
ClickUpタスクをAIアプリケーションと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIエージェントは標準化されたプロトコルを介してClickUpタスク、スペース、リスト、フォルダーと対話できるようになります。
🚀**ステータス更新:**完全な時間追跡サポートとドキュメント管理機能を備えた v0.7.2 が利用可能になりました。
設定
- 資格情報を取得します:
- 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
注意: 「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カバレッジ |
利用可能なツール
| 道具 | 説明 | 必須パラメータ |
|---|---|---|
| ワークスペース階層を取得する | ワークスペース構造を取得する | なし |
| タスク作成 | タスクを作成する | 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 | 現在実行中のタイマーを取得する | なし |
| ワークスペースメンバーを取得する | ワークスペースのメンバー全員を取得する | なし |
| 名前でメンバーを探す | 名前またはメールアドレスでメンバーを検索 | nameOrEmail |
| 担当者の解決 | メンバー名をIDに解決する | assignees[] |
| ドキュメントの作成 | ドキュメントを作成する | workspaceId 、 name 、 parentId / parentType 、 visibility 、 create_pages |
| ドキュメントを取得する | ドキュメントを取得する | workspaceId / documentId |
| ドキュメント一覧 | ドキュメントの一覧 | workspaceId 、 documentId / creator / deleted / archived済み / parent_id / parent_type / limit / next_cursor |
| ドキュメントページ一覧 | ドキュメントページの一覧 | documentId / documentName |
| ドキュメントページを取得する | ドキュメントページを取得する | documentId / documentName 、 pageIds |
| ドキュメントページの作成 | ドキュメントページを作成する | workspaceId / documentId 、 parent_page_id / name / sub_title 、 content / content_format |
| ドキュメントページの更新 | ドキュメントページを更新する | workspaceId / documentId ID、 name / sub_title 、 content / コンテンツcontent_edit_mode / content_format |
オプションのパラメータと高度な使用法については、完全なドキュメントを参照してください。
会員管理ツール
タスク作成時に、 assigneesパラメータを使ってユーザーを割り当てることができるようになりました。このパラメータは、ユーザーID、メールアドレス、またはユーザー名の配列を受け入れます。
メンバー管理ツールは、必要に応じてユーザー参照を解決するのに役立ちます。
プロンプト
まだ実装されておらず、すべてのクライアントアプリでサポートされているわけではありません。ワークフローに最も役立つと思われるPromptの実装機能をリクエストしてください（具体的な内容は問いません）。例：
エラー処理
サーバーは、次の場合に明確なエラー メッセージを提供します。
- 必要なパラメータが不足しています
- 無効なIDまたは名前
- アイテムが見つかりません
- 権限の問題
- APIエラー
- レート制限
LOG_LEVEL環境変数を指定することで、サーバーログの詳細度を制御できます。有効な値は、 trace 、 debug 、 info 、 warn 、 error （デフォルト）です。これはコマンドラインでも指定できます（例： --env LOG_LEVEL=info ）。
開発者をサポートする
このサーバーをご利用の際に、ツールのレスポンスにこのリポジトリへのリンクを含む小さなスポンサーメッセージが表示されることがあります。プロジェクトへのご支援をお待ちしております。このプロジェクトが役に立つと思われましたら、ぜひご支援ください。
謝辞
この統合を可能にした優れた API とサービスについて、 ClickUpに特に感謝します。
貢献
貢献を歓迎します！詳細については貢献ガイドをご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
免責事項
本ソフトウェアはサードパーティのAPIを利用しており、サードパーティが所有する商標またはブランドを参照する場合があります。これらのAPIまたは参照の使用は、各企業との提携または推奨を意味するものではありません。すべての商標およびブランド名はそれぞれの所有者の財産です。本プロジェクトは独立した作品であり、言及されているいかなるサードパーティ企業とも公式に提携またはスポンサー契約を結んでいません。
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
ClickUp タスクとの AI 統合を可能にし、標準化されたプロトコルを通じてリソース管理、タスク操作、ワークスペース編成、AI を活用したタスク推奨をサポートします。
- Smithery のインストール (クイック スタート)
- NPXのインストール
- SSEサポートで実行
- Docker-compose の例
- 特徴
- 利用可能なツール
- 会員管理ツール
- プロンプト
- エラー処理
- 開発者をサポートする
- 謝辞
- 貢献
- ライセンス
- 免責事項
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.Last updated -0JavaScript
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -40343TypeScriptMIT License
- AsecurityAlicenseAqualityClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.Last updated -42594TypeScriptMIT License