clickup-mcp

clickup-mcp

メンテナンス終了。 CAVORT では ClickUp の利用を終了しました（2026-10-18、Console への移行が完了）。このサーバーは現状のまま維持され、今後開発されることはありません。

タスク管理に特化した軽量な ClickUp MCP サーバーです。トークンを最適化した応答を返す 40 個のツールを備え、API 応答を数千文字から必要な情報だけに自動で絞り込みます。

このサーバーを選ぶ理由

ClickUp API が返す JSON は非常に冗長です。このサーバーは内容を絞り込みます。

応答	変換前	変換後	削減率
clickup_whoami	約 3,500 文字	約 160 文字	95%
clickup_create_comment	約 1,500 文字	約 38 文字	97%

トークンが少ないほど、応答が速くなり、コストが下がり、AI のためのコンテキストが増えます。

インストール

npm install -g @cavort-it-systems/clickup-mcp

または、直接実行します。

npx @cavort-it-systems/clickup-mcp

設定

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / 手動設定

MCP 設定（~/.claude.json または Claude Desktop の設定）に追加します。

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

ソースからのインストール

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
pnpm install && pnpm build

続いて、ビルドしたパスを指定して設定します。

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

カスタムタスク ID

task_id を受け取るすべてのツールでは、内部 ID（86caqr85m）だけでなく、カスタム ID（DEV-1217）も使用できます。サーバーが custom_task_ids=true&team_id=... を自動的に追加します。 ワークスペース ID は CLICKUP_TEAM_ID から取得されます。未設定の場合は、トークンに紐づく唯一のワークスペースを一度だけ検索して使用します。複数のワークスペースにアクセスできるトークンでは、CLICKUP_TEAM_ID を設定する必要があります。

API トークンの取得

1. ClickUp Settings > Apps に移動します
2. Personal API Token を生成します
3. CLICKUP_API_TOKEN に設定します

応答の絞り込み

トークンを節約するため、すべての応答が自動的に簡潔化されます。ClickUp API が返す非常に冗長な JSON を、このサーバーが重要な情報だけに絞り込みます。

clickup_whoami - 約 3,500 文字から約 160 文字に削減：

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"[email protected]","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"[email protected]",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"[email protected]",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment - 約 1,500 文字から 38 文字に削減：

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

削除される内容：

フィールド	対象	理由
features{}	スペース	スペースごとに約 50 行あるブール値フラグ
sharing{}、permission_level	タスク	内部アクセス設定であり、実用性がない
watchers[]	タスク	通常、担当者と同じ
ユーザーオブジェクト全体	全体	{id, username, email} に縮小
profilePicture、initials、color	ユーザー	LLM にとって有用でない視覚的なメタデータ
version{} のデータ	コメント／返信の作成時	内部バージョン管理データ
invited_by、profileInfo	メンバー	招待に関するメタデータ
JSON の整形表示	すべての応答	1 行のコンパクトな出力にするため
空の配列	タスク	checklists、dependencies、custom_fields は空の場合に省略

ツール（40）

ナビゲーション（7）

• clickup_whoami - 現在のユーザーとワークスペースを取得
• clickup_get_spaces - ワークスペース内のスペースを一覧表示
• clickup_get_folders - スペース内のフォルダーを一覧表示
• clickup_get_lists - フォルダーまたはスペース内のリストを一覧表示
• clickup_get_list - 単一のリストの詳細を取得
• clickup_create_list - フォルダーまたはスペースにリストを作成
• clickup_delete_list - リストを削除（元に戻せません）

タスク CRUD（5）

• clickup_get_task - ID でタスクを取得
• clickup_create_task - すべてのフィールドを指定してタスクを作成
• clickup_update_task - タスクの任意のフィールドを更新
• clickup_get_tasks - リスト内のタスクを一覧表示
• clickup_search_tasks - ワークスペース内のタスクを検索

カスタムフィールド（1）

• clickup_set_custom_field - カスタムフィールドの値を設定

タグ（6）

• clickup_get_space_tags - スペースのタグを一覧表示
• clickup_create_space_tag - タグを作成
• clickup_edit_space_tag - タグを編集
• clickup_delete_space_tag - タグを削除
• clickup_add_tag_to_task - タスクにタグを付ける
• clickup_remove_tag_from_task - タスクからタグを外す

チェックリスト（6）

• clickup_create_checklist - チェックリストを作成
• clickup_edit_checklist - チェックリストを編集
• clickup_delete_checklist - チェックリストを削除
• clickup_create_checklist_item - 項目を追加
• clickup_edit_checklist_item - 項目を編集
• clickup_delete_checklist_item - 項目を削除

依存関係（4）

• clickup_add_dependency - 依存関係を追加
• clickup_delete_dependency - 依存関係を削除
• clickup_add_task_link - タスクをリンク
• clickup_delete_task_link - タスクのリンクを解除

コメント（5）

• clickup_create_comment - コメントを追加
• clickup_get_comments - コメントを取得
• clickup_update_comment - コメントを編集／解決
• clickup_create_reply - スレッド形式で返信
• clickup_get_replies - 返信を取得

タスクの削除（1）

• clickup_delete_task - タスクを削除

複数リストへの所属（2）

• clickup_add_task_to_list - タスクを追加のリストに追加（複数リストへの所属）
• clickup_remove_task_from_list - タスクを追加のリストから削除

これらの操作ではタスクは移動しません。 ClickUp v2 API にはリスト間の移動用エンドポイントがありません。 ライブ API で 2026-08-12 に確認済みです。POST /list/{list}/task/{task} はセカンダリの場所を追加し、ホームリストは変更しません。一方、PUT /task/{id} の list_id は HTTP 200 を返しますが、黙って無視されます。カスタム ID と履歴を維持したままタスクを実際に移動するには、ClickUp のウェブ UI（右クリック -> Move）を使用してください。複数リストへの所属には、有料の Tasks-in-Multiple-Lists 機能も必要です。

添付ファイル（1）

• clickup_upload_attachment - ローカルファイル（スクリーンショット、PDF）をタスクにアップロード

ワークスペースメンバー（2）

• clickup_get_workspace_members - ワークスペースのすべてのメンバー
• clickup_get_list_members - リスト固有のメンバー

アーキテクチャ

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools
    attachments.ts  # 1 tool (multipart upload)

ライセンス

MIT