ClickUp MCP (Streamable HTTP)

ClickUp REST API用のMCPサーバーで、以下の機能を備えています：

• ワークスペース全体のタスク検索 (GET /team/{team_id}/task)

• タスクのCRUD操作（サブタスクを含む）

• 基本的なブラウジング（チーム、スペース、フォルダ、リスト）

• 最近のアクティビティヘルパー (date_updated_gt および利用可能な場合の監査ログ経由)

• ドキュメントのCRUD/検索 (v3 API): ドキュメントやページの検索、取得、作成

• エスケープハッチ: ClickUp APIエンドポイント（v2およびv3）を呼び出すための汎用ツール

このサーバーはDockerサービスとして実行し、OpenWebUIやLibreChatから利用することを想定しています。

環境変数

• CLICKUP_API_TOKEN (必須)

• CLICKUP_TEAM_ID (任意、未設定の場合は最初のチームを自動検出)

• CLICKUP_WORKSPACE_ID (任意; ClickUpではv2で「team_id」と呼ばれることが多い)

• CLICKUP_API_BASE_URL (任意、デフォルト https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (任意、デフォルト https://api.clickup.com/api/v3)

実行 (ローカル)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUIは http://clickup-mcp:8000/mcp に接続する必要があります。

ツール

タスク (v2 API)

• search_tasks - 名前/説明でタスクを検索

• filter_tasks - メタデータ（ステータス、担当者、日付など）でタスクをフィルタリング

• get_task - IDでタスクを取得

• create_task - 新しいタスクを作成

• create_subtask - 既存のタスクの下にサブタスクを作成

• update_task - タスクを更新

• delete_task - タスクを削除

• get_task_comments - タスクのコメントを取得

• create_task_comment - タスクにコメントを作成

ブラウジング (v2 API)

• clickup_context - 解決されたコンテキスト（チーム/ワークスペースIDおよび現在のユーザー）を取得

• list_teams - ClickUpのチーム/ワークスペースを一覧表示

• get_team - IDでチームを取得

• list_spaces - チーム内のスペースを一覧表示

• list_folders - スペース内のフォルダを一覧表示

• list_lists_in_space - スペース内の（フォルダに属さない）リストを一覧表示

• list_lists_in_folder - フォルダ内のリストを一覧表示

• list_tasks_in_list - リスト内のタスクを一覧表示

ドキュメント (v3 API)

• search_docs - ワークスペース内のすべてのドキュメントを検索/一覧表示

• get_doc - IDでドキュメントを取得（ページリストを含む）

• create_doc - 新しいドキュメントを作成

ページ (v3 API)

• list_doc_pages - ドキュメント内のすべてのページを一覧表示

• get_doc_page_listing - ドキュメントの階層的なページ構造を取得

• get_doc_page - 特定のページを取得（コンテンツを含む）

• create_doc_page - ドキュメント内に新しいページを作成

• update_doc_page - ページを更新/編集（コンテンツの置換、追加、または先頭への挿入）

ユーティリティ

• recent_activity - 最近のアクティビティを取得（監査ログまたは最近更新されたタスク）

• clickup_api_request - 汎用v2 APIエスケープハッチ

• clickup_v3_api_request - 汎用v3 APIエスケープハッチ

• health - ヘルスチェック