ClickUp MCP Pro

ClickUp MCP Pro

最も充実した ClickUp MCP サーバーです。161 個の型付きツールと clickup_raw で ClickUp v2/v3 API 全体をカバーします。有料の代替製品に匹敵、あるいはそれを上回ることを目指して構築された、無料のオープンソースです。

ClickUp MCP Pro は、ほぼすべての ClickUp 操作を型付きの Model Context Protocol ツールとして公開します。これにより、Claude Code（およびあらゆる MCP クライアント）から、タスク、リスト、フォルダー、スペース、ドキュメント、チャット、目標、スプリント、時間追跡、カスタムフィールド、ウェブフック、ゲストなど、ワークスペース全体を操作できます。ニッチなエンドポイントがラップされていない場合は、clickup_raw から API の残りの部分に直接アクセスでき、100% のカバー率を実現します。

主な特長

• 161 個の型付きツールで ClickUp の 23 ドメイン（v2 + v3 API）をカバーします。
• clickup_raw によるエスケープハッチ — まだラップされていない任意のエンドポイントを呼び出せます。アクセスできない機能はありません。
• 読み取り専用モード（CLICKUP_READONLY=true）では、読み取りを可能にしたまま、すべての書き込みをブロックします。安全に調査できます。
• 自然言語の日付 — "tomorrow"、"in 3 days"、"+2h"、ISO 形式、エポックミリ秒を、あらゆる日付フィールドで使用できます。
• 名前から ID への解決 — find_member、find_space_by_name、find_list_by_name。
• 堅牢なクライアント — 429/5xx 応答時にバックオフ付きで自動再試行し、Retry-After に対応。エラー時には具体的な対処方法を提示します。
• 一括操作では、項目ごとの成功・エラーを報告します（部分的な失敗があってもバッチ全体が失われることはありません）。

概要

領域	ツール	領域	ツール
ワークスペース／チーム	6	時間追跡	14
スペース	5	ドキュメント（v3）	8
フォルダー	7	ビュー	7
リスト	9	目標と主要な成果	8
タスク（基本）	11	チャット（v3）	18
タスク（一括）	4	スプリント	3
タスクのリンクと依存関係	6	Webhook	4
コメントとスレッド	10	ユーザーグループ	4
チェックリスト	6	ゲスト（Enterprise）	10
添付ファイル	2	メンバーとリゾルバー	5
タグ	6	テンプレート	2
カスタムフィールド	6	clickup_raw	1

インストールと設定

1. ClickUp Personal API Token を取得する

ClickUp → Settings → Apps → API Token（pk_ で始まります）。

2. Claude Code に追加する

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp-pro"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_token_here",
        "CLICKUP_TEAM_ID": "9007012345"
      }
    }
  }
}

または、ソースから実行する場合：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["d:/GitHub/easypanel-mcp/projects/clickup-mcp-pro/dist/index.js"],
      "env": { "CLICKUP_API_TOKEN": "pk_your_token_here" }
    }
  }
}

3. Claude Desktop

ファイル：%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）— 上記と同じ mcpServers ブロックを使用します。

環境変数

変数	必須	デフォルト	説明
CLICKUP_API_TOKEN	✅	—	Personal API token（pk_...）。CLICKUP_TOKEN も使用できます。
CLICKUP_TEAM_ID	—	—	ツールで team_id が省略された場合に使用するデフォルトのチーム／ワークスペース ID。
CLICKUP_READONLY	—	false	true にすると、すべての書き込みがブロックされます（読み取りは引き続き可能です）。
CLICKUP_DISABLE_RAW	—	false	true にすると、clickup_raw ツールが非表示になります。
CLICKUP_UPLOAD_DIR	—	—	upload_task_attachment(file_path) の対象を、この基準ディレクトリに制限します。
CLICKUP_MAX_UPLOAD_BYTES	—	52428800	アップロードできる添付ファイルの最大サイズ（50 MB）。
CLICKUP_TIMEOUT_MS	—	60000	リクエストごとのタイムアウト。
CLICKUP_MAX_RETRIES	—	3	429／5xx／ネットワークエラー時の最大再試行回数。

セキュリティに関する注意

このサーバーはローカルで実行され、トークンに代わって操作を行うため、悪意のあるプロンプトがツール呼び出しを悪用する一般的な手口に対する保護を強化しています。

• upload_task_attachment(url) は HTTPS URL のみを取得し、プライベート／ループバック／リンクローカルアドレスに解決されるホストを拒否します（SSRF 対策）。リダイレクトには従いません。
• upload_task_attachment(file_path) は CLICKUP_UPLOAD_DIR を使ってディレクトリ内に制限でき、任意のローカルファイルの持ち出しを防止できます。アップロードサイズには上限があります（CLICKUP_MAX_UPLOAD_BYTES）。注：CLICKUP_UPLOAD_DIR 内に、ディレクトリ外を指すシンボリックリンクを置かないでください。
• clickup_raw はパスを検証します（スキーム、ホスト、..、@ を含まない、適切な相対 API パスである必要があります）。また、CLICKUP_READONLY=true の場合は書き込みがブロックされます。信頼できない環境では、CLICKUP_DISABLE_RAW=true を設定して完全に無効にしてください。
• API トークンは認証ヘッダーとしてのみ送信され、ログに記録されたり、エラーメッセージに出力されたりすることはありません。

ソースからビルドする

cd projects/clickup-mcp-pro
npm install
npm run build
# Inspect interactively:
npm run inspector

ツールのリファレンス

ワークスペース／チーム

get_workspaces、get_workspace_seats、get_workspace_plan、get_workspace_members、get_custom_task_types、get_authorized_user

スペース

list_spaces、get_space、create_space、update_space、delete_space、get_space_tags

フォルダー

list_folders、get_folder、create_folder、create_folder_from_template、update_folder、delete_folder、get_folder_views

リスト

get_lists_in_folder、get_folderless_lists、get_list、create_list_in_folder、create_folderless_list、create_list_from_template_in_folder、update_list、delete_list、get_list_views

タスク

get_tasks、get_task、get_workspace_tasks、create_task、update_task、delete_task、get_subtasks、duplicate_task、set_task_custom_field_value、remove_task_custom_field_value、get_task_members 一括：create_bulk_tasks、update_bulk_tasks、delete_bulk_tasks、move_bulk_tasks リンクと依存関係：add_task_link、delete_task_link、add_task_dependency、delete_task_dependency、add_task_to_list、remove_task_from_list

コメント

get_task_comments、create_task_comment、get_list_comments、create_list_comment、get_chat_view_comments、create_chat_view_comment、update_comment、delete_comment、get_threaded_comments、create_threaded_comment

チェックリスト

create_checklist、edit_checklist、delete_checklist、create_checklist_item、edit_checklist_item、delete_checklist_item

添付ファイル

upload_task_attachment（ローカルパス／URL／base64）、list_task_attachments

タグとカスタムフィールド

get_space_tags、create_space_tag、update_space_tag、delete_space_tag、add_tag_to_task、remove_tag_from_task get_list_custom_fields、get_folder_custom_fields、get_space_custom_fields、get_workspace_custom_fields、set_custom_field_value、remove_custom_field_value

時間管理

get_time_entries、get_time_entry、get_running_time_entry、start_time_entry、stop_time_entry、create_time_entry、update_time_entry、delete_time_entry、get_time_entry_history、get_all_time_entry_tags、add_tags_to_time_entries、remove_tags_from_time_entries、get_task_time_in_status、get_bulk_tasks_time_in_status

ドキュメント（v3）

search_docs、get_doc、create_doc、get_doc_page_listing、get_doc_pages、get_doc_page、create_doc_page、update_doc_page（置換／追記／先頭に追加）

ビュー

get_team_views、get_space_views、get_view、get_view_tasks、create_view、update_view、delete_view

目標

get_goals、get_goal、create_goal、update_goal、delete_goal、create_key_result、update_key_result、delete_key_result

チャット（v3）

list_chat_channels、get_chat_channel、create_chat_channel、create_chat_channel_on_location、create_chat_direct_message、update_chat_channel、get_chat_channel_members、get_chat_channel_followers、get_chat_messages、send_chat_message、update_chat_message、delete_chat_message、get_chat_message_replies、create_chat_message_reply、get_chat_message_reactions、create_chat_message_reaction、delete_chat_message_reaction、get_chat_message_tagged_users

スプリント／Webhook／ユーザーグループ／ゲスト／テンプレート

list_sprints、get_active_sprint、get_sprint_tasks list_webhooks、create_webhook、update_webhook、delete_webhook list_user_groups、create_user_group、update_user_group、delete_user_group invite_guest、get_guest、edit_guest、remove_guest、add_guest_to_task、remove_guest_from_task、add_guest_to_list、remove_guest_from_list、add_guest_to_folder、remove_guest_from_folder get_task_templates、create_task_from_template

メンバーと検索関数

get_task_assignable_members、get_list_members、find_member、find_space_by_name、find_list_by_name

フォールバック手段

clickup_raw — 任意のClickUp v2/v3エンドポイントを直接呼び出します。例：

{ "method": "GET", "path": "/team/9007012345/space", "version": "v2" }

比較

	ClickUp MCP Pro	taazkareem（有料）	Nazruden	DiversioTeam
型付きツール	161	~150	~30	~28
直接呼び出しのフォールバック手段	✅	—	—	—
読み取り専用モード	✅	—	—	—
チャット／目標／スプリント	✅	✅	—	—
ドキュメント（v3）	✅	✅	✅	—
時間管理	✅	✅	—	一部対応
価格	無料／MIT	有料	無料	無料

ライセンス

MIT © Helbert Paranhos / Strat Academy

• GitHub：@helbertparanhos
• Strat Builderメタシステムを使用して構築されています。