ClickUp MCP Integration

by Leanware-io
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables interaction with ClickUp workspaces, providing tools for creating new tasks with various properties (descriptions, priority levels, due dates, tags), retrieving detailed task information by task ID, and looking up tasks using custom IDs.

ClickUp MCP統合

ClickUp とのシームレスな統合を提供するモデル コンテキスト プロトコル サーバー。これにより、大規模言語モデルが ClickUp ワークスペースのタスクおよびデータと対話できるようになります。

利用可能なツール

この MCP サーバーは、ClickUp と対話するための次のツールを提供します。

clickup_create_task

ClickUp ワークスペースに新しいタスクを作成します。

  • 必須入力:
    • name (文字列): タスク名
    • list_id (文字列): タスクが作成されるClickUpリストのID
  • オプション入力:
    • markdown_description (文字列): マークダウン形式でのタスクの説明
    • priority (数字):タスクの優先度(1=緊急、2=高、3=標準、4=低)
    • due_date (数値): 期日をUnixタイムスタンプでミリ秒単位で表したもの
    • tags (文字列の配列): タスクに追加するタグ名
    • time_estimate (数値): ミリ秒単位での推定時間
  • 戻り値: 新しく作成されたタスクの詳細

clickup_get_task

ID を使用して特定のタスクの詳細情報を取得します。

  • 必須入力:
    • task_id (文字列): ClickUp タスク ID
  • 戻り値: 説明、ステータス、担当者、メタデータを含む完全なタスクの詳細

clickup_get_task_by_custom_id

カスタム ID を使用してタスク情報を取得します。

  • 必須入力:
    • custom_id (文字列): タスクのカスタムID
  • 戻り値: 説明、ステータス、担当者、メタデータを含む完全なタスクの詳細

建てる

走る:

npm i npm run build npm run inspector

Dockerビルド:

docker buildx build -t {your-docker-repository} --platform linux/amd64,linux/arm64 . docker push {your-docker-repository}

設定

1. ClickUp APIトークンの取得:

  1. app.clickup.comでClickUpアカウントにログインしてください。
  2. 左下のプロフィール写真をクリックしてユーザー設定に移動します
  3. 「設定」を選択
  4. 左側のサイドバーの「アプリ」をクリックします
  5. 「APIトークン」の下で、トークンをまだ持っていない場合は「生成」をクリックします。
  6. 生成されたAPIトークンをMCPサーバー構成で使用するためにコピーします。

2. ワークスペースIDを見つける:

  1. ウェブブラウザでClickUpを開きます
  2. ワークスペースにいるときにURLを確認してください
  3. ワークスペース ID は、URL 内の数値です: https://app.clickup.com/{workspace_id}/home
  4. この番号をコピーして、MCP サーバーの構成に使用します。

3. Docker をインストールします: https://docs.docker.com/engine/install/

4a. Cline MCP サーバーをセットアップする:

  • VSCode または Jetbrains IDE を開き、Cline に移動します。
  • MCP サーバー → インストール済み → MCP サーバーの構成に移動します。
  • cline_mcp_settings.jsonmcpServersキー内に次のコードを追加します。
"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }

4b. Claude Desktop MCP Server のセットアップ:

  • 任意のエディターを使用して、Claude Desktop の構成ファイルを開きます。
    • Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
    • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • claude_desktop_config.jsonmcpServersキー内に次のコードを追加します。
"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }
  • 設定ファイルを保存する
  • 変更を適用するには、Claude Desktopを再起動してください。

トラブルシューティング

MCP サーバーで問題が発生した場合:

  1. 認証エラー:
    • APIトークンが正しいことを確認してください
    • APIトークンに、実行しようとしている操作に必要な権限があることを確認してください。
    • ワークスペースIDが正しいことを確認してください
  2. タスク アクセスの問題:
    • 取得しようとしているタスクにアクセスできることを確認してください
    • タスクIDが正しく、ワークスペースに存在することを確認します
    • タスクがアーカイブ状態になっているかどうかを確認する
  3. 接続の問題:
    • Dockerサービスが適切に実行されていることを確認する
    • ネットワーク接続を確認してください
    • MCP構成で環境変数が正しく設定されていることを確認します

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。

-
security - not tested
A
license - permissive license
-
quality - not tested

大規模言語モデルが ClickUp ワークスペースのタスクおよびデータと対話できるようにし、自然言語によるタスクの作成と取得を可能にするモデル コンテキスト プロトコル サーバー。

  1. Available Tools
    1. clickup_create_task
    2. clickup_get_task
    3. clickup_get_task_by_custom_id
  2. Build
    1. Setup
      1. Troubleshooting
    2. License
      ID: mcxzcscusd