clickup-mcp

タスク管理に特化した軽量なClickUp MCPサーバー。トークン最適化されたレスポンスを備えた39のツールを提供し、APIレスポンスを数千文字から必須情報のみに自動的に絞り込みます。

このサーバーが選ばれる理由

ClickUpのAPIは非常に冗長なJSONを返します。このサーバーはそれを削減します:

トークンが少ないほど、レスポンスが速くなり、コストが低くなり、AIにとってより多くのコンテキストが得られます。

Related MCP server: ClickUp MCP Server

インストール

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
npm install && npm run build

次に、ビルドしたパスを設定します:

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

APIトークンを取得する

1. ClickUpの設定 > アプリに移動します

2. 個人用APIトークンを生成します

3. CLICKUP_API_TOKEN として設定します

レスポンスのスリム化

すべてのレスポンスはトークンを節約するために自動的に削減されます。ClickUp APIは非常に冗長なJSONを返しますが、このサーバーは重要な情報だけに絞り込みます。

clickup_whoami - 約3,500文字から約160文字へ:

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","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":"bob@example.com",
"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":"jane@example.com",
"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}

削減される内容:

ツール (37)

ナビゲーション (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（右クリック -> 移動）を使用してください。 複数リスト所属には、有料のTasks-in-Multiple-Lists機能も必要です。

ワークスペースメンバー (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

ライセンス

MIT