ClickUp MCP Server

ClickUp MCP Server とは？

この ClickUp MCP サーバーは、taazkareem が独自にメンテナンスする商用の Model Context Protocol サーバーです。AI エージェントが自然言語で ClickUp のタスク、リスト、スプリント、ドキュメント、チャット、コメント、時間記録を管理できるようにするもので、有料ライセンスが必要です。

このプロジェクトは当初オープンソースでしたが、のちに有料モデルへ移行しました。README によると、ClickUp とのコンサルティング期間中に改良されたものの、現在は独立してメンテナンスされており、ClickUp との提携や推奨関係はありません。ライセンスで約 150 のツールが使えるようになります。ホスト型のリモートサーバー（https://clickup-mcp.taazkareem.com/mcp）としても、npm パッケージ @taazkareem/clickup-mcp-server によるローカルの stdio としても動作します。なお、ClickUp 自身も公式の MCP サーバーを提供しています（後述）。

ClickUp MCP Server の使い方

前提条件：

• Polar.sh で購入するライセンスキー（月額、年額、買い切りの 3 種類で、いずれも 3 台までのデバイス認証付き）。
• ローカルの stdio を使う場合のみ：ClickUp の API トークン（ClickUp Settings > Apps の「API Token」で Generate）と、ワークスペース URL の app.clickup.com/ の直後にある数字である Team ID。リモートではどちらも不要です。

リモートサーバーは X-License-Key ヘッダーと、ClickUp アカウントへの OAuth 2.1 で認証します。ローカルでは API キー、Team ID、ライセンスキーを環境変数で渡します。

Claude Code

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

Claude Desktop

リモート接続では claude_desktop_config.json で mcp-remote アダプターを使います。

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header",
        "X-License-Key: your-license-key"
      ]
    }
  }
}

Cursor

<project-root>/.cursor/mcp.json に追加します（リモート）。

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

または stdio でローカル実行します。

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json（ワークスペース）またはユーザーレベルの mcp.json に、同じリモートまたはローカルの JSON を記述します。

Codex

~/.codex/config.toml に追加します。

[mcp_servers.ClickUp]
url = "https://clickup-mcp.taazkareem.com/mcp"
http_headers = { "X-License-Key" = "your-license-key" }

README では Windsurf、Roo Code、Augment、n8n、ChatGPT、Antigravity、Hermes の設定も紹介されています。n8n 向けにはセルフホスト用の Docker イメージがあります：docker run -d -p 3231:3231 ghcr.io/taazkareem/clickup-mcp-server:latest。

ClickUp MCP Server の主な機能

• ハイブリッド認証：セッション分離キャッシュ付きの OAuth 2.1 で、API キーと Team ID にも後方互換。
• タスク・リスト・フォルダー・スペース名、カスタムフィールド、メンバー、ステータス、タグを横断するグローバルなあいまい検索で、AI が生の ID をほとんど必要としない。
• 完全なタスク管理：CRUD、移動、複製、リンク、依存関係、一括操作、サブタスク、チェックリスト、カスタムフィールド、テンプレート、添付ファイル。
• タイマー、手動入力、編集履歴、自然言語の日付によるワークスペース全体の絞り込みを備えた時間記録。
• markdown ページ対応の ClickUp Docs と、スレッド返信やリアクション付きのコメント・チャットチャンネル。
• 目標とキーリザルト、ビュー、Webhook、タグ、階層の各レベルでのアクセス制御。
• 追加の API キーで、1 つのセッションから複数のワークスペースを扱える。
• 名前、カテゴリー、ペルソナでツールを絞り込み、コンテキストのノイズを減らせる。

ClickUp MCP Server のツール

ライセンス適用後のサーバーは約 150 のツールを公開しており、カテゴリーごとに分かれています。

• タスク：create_task、update_task、move_task、create_bulk_tasks、get_workspace_tasks（ディープ検索）、add_task_dependency、タスクのリンク。
• コメント・チェックリスト・添付ファイル：create_comment、create_comment_reply、create_checklist、create_checklist_item、upload_attachment。
• スプリントと構造：get_active_sprint、list_sprints に加え、スペース・フォルダー・リストの作成・更新・移動ツール（set_list_permissions を含む）。
• 時間記録：start_time_entry、stop_time_entry、add_time_entry、get_time_entries、get_time_in_status。
• ドキュメントとチャット：create_document、update_document_page、create_chat_message、create_chat_message_reply。
• 目標・ビュー・Webhook・管理：create_goal、create_key_result、create_view、create_webhook、ユーザーグループ、ゲスト、get_audit_logs（Enterprise）。

エージェントに見せるツールを制限するには、ローカルでは ENABLED_TOOLS / ENABLED_CATEGORIES、リモートでは X-Enabled-Tools / X-Enabled-Categories ヘッダーを設定します。CLICKUP_MCP_PERSONA または X-Persona でペルソナを選ぶこともでき、auditor（読み取り専用）、task_worker、project_manager、safe_power_user（破壊的な削除以外すべて）などがあります。

ClickUp MCP Server のユースケース

• チャットで作業を計画：「Q3 のローンチをサブタスクと担当者付きのリストに分解して。」
• スプリントの状況確認：「Sprint ボードを監査して、リスクのある項目を報告して。」
• エディターから離れずに時間を記録：「ログインバグのタスクでタイマーを開始して」、続けて「昨日のコードレビューに 45 分を記録して」。
• ドキュメントを最新に保つ：「今日のリリースノートを Engineering Changelog ドキュメントに追記して。」
• ワークスペースをまたいで整理する。たとえば、認可済みの 2 つの ClickUp アカウント間でタスクを移動・複製する。
• auditor ペルソナで読み取り専用のレポート用エージェントを動かす。

ClickUp MCP Server と代替ツールの比較

ClickUp 自身の公式 MCP サーバーは ClickUp ヘルプセンター に記載されており、ClickUp がホストしています。ベンダーがサポートする接続を求めるなら、まずはこちらが候補です。taazkareem のこのサーバーは有料のサードパーティ製で、非常に多くのツール、ペルソナ、ツールの絞り込み、複数ワークスペースのセッションを強みとしています。ほかのプロジェクト管理ツールについては Asana MCP Server、Linear MCP Server、Trello MCP Server を参照してください。

ClickUp MCP Server のトラブルシューティング

• 古い無料版に修正が届かない：以前のバージョンも動作しますが、ライセンスがないとアップデート、バグ修正、サポートは受けられません。
• リモートでライセンスが認識されない：ヘッダーが正確に X-License-Key: your-license-key になっているか確認します。Claude Desktop でこのヘッダーを送るには mcp-remote アダプターが必要です。
• ローカルの stdio でワークスペースにアクセスできない：CLICKUP_API_KEY と CLICKUP_TEAM_ID を確認します。Team ID は URL の app.clickup.com/ の直後にある数字です。
• ツールが多すぎてコンテキストを圧迫する：ENABLED_CATEGORIES や task_worker などのペルソナで絞り込みます。
• n8n から Docker に接続できない：URL に http://host.docker.internal:3231/mcp を使います。