Clickup MCP

🚀 clickup - mcp

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

🚀 クイックスタート

このサーバーは、ClickUpのAPIが返す非常に冗長なJSONを削減するために開発されました。以下の表は、レスポンスの削減率を示しています。

トークンの削減により、レスポンスが高速化し、コストが削減され、AIにより多くのコンテキストを提供できます。

✨ 主な機能

• 37のツールを備え、タスク管理に特化した軽量なClickUp MCPサーバー
• トークン最適化されたレスポンスを提供し、APIレスポンスを自動的に必要な情報のみに絞り込む

📦 インストール

グローバルインストール

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 / 手動設定

~/.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文字に削減:

// 変更前 (ClickUp API 生データ)
{"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,...}, ...]}]}}

// 変更後 (削減済み)
{"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文字に削減:

// 変更前
{"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":"*"},...},...},...}}

// 変更後
{"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_get_workspace_members - すべてのワークスペースメンバー
• clickup_get_list_members - リスト固有のメンバー

🔧 技術詳細

src/
  index.ts          # エントリー: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2フェッチラッパー
  types.ts          # 共有Zodスキーマ + jsonResultヘルパー
  slim.ts           # レスポンス削減トランスフォーマー
  tools/
    navigation.ts   # 7つのツール
    tasks.ts        # 7つのツール (CRUD + カスタムフィールド + 削除)
    tags.ts         # 6つのツール
    checklists.ts   # 6つのツール
    dependencies.ts # 4つのツール
    comments.ts     # 5つのツール
    members.ts      # 2つのツール

📄 ライセンス

MIT