Clickup について
Clickup は、ClickUp REST API v2 をラップし、ワークスペースのタスクやスペースを管理する MCP サーバーです。開発者や AI クライアント向けで、Pipeworx ゲートウェイ経由とローカルの stdio サーバーの両方で利用できます。
主な機能
- 01リスト内のタスク一覧
- 02タスク詳細の取得
- 03優先度や担当者を指定したタスク作成
- 04ワークスペースのスペース一覧
- 05スペース内のフォルダー一覧
活用シーン
- 01タスクとステータスを確認
- 02タスクの説明や時間追跡情報を取得
- 03ClickUp リストにタスクを作成
- 04ワークスペースのスペースとフォルダーを調査
MCP 対応
ClickUp REST API v2 の操作を MCP ツールとして提供します。Pipeworx ゲートウェイ経由またはローカルの stdio MCP サーバーとして接続でき、ゲートウェイには Pipeworx 共通メタツールも含まれます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/clickup/mcpclaude mcp add --transport http pipeworx-io-clickup https://gateway.pipeworx.io/clickup/mcp{"mcpServers":{"pipeworx-io-clickup":{"type":"http","url":"https://gateway.pipeworx.io/clickup/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-clickup":{"type":"http","url":"https://gateway.pipeworx.io/clickup/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-clickup":{"type":"http","url":"https://gateway.pipeworx.io/clickup/mcp"}}}{"mcpServers":{"pipeworx-io-clickup":{"serverUrl":"https://gateway.pipeworx.io/clickup/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-clickup
ClickUp MCP — ClickUp REST API v2 をラップします(API キーはご自身で用意してください)
Pipeworx の一部です。AI エージェントを 1875 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとは提携関係になく、承認や公開も受けていません。
ツール
| ツール | 説明 |
|---|---|
clickup_list_tasks | ClickUp リスト内のすべてのタスクを一覧表示します。タスク ID、名前、ステータス、優先度、担当者、期限、URL を返します。リスト ID(例:「123456」)を指定してください。 |
clickup_get_task | 名前、説明、ステータス、優先度、担当者、タグ、時間追跡など、タスクの詳細を取得します。タスク ID(例:「9hz6c」)を指定してください。 |
clickup_create_task | ClickUp リストに新しいタスクを作成します。リスト ID、タスク名を指定し、必要に応じて優先度と担当者も指定してください。タスク ID、名前、ステータス、URL を返します。 |
clickup_list_spaces | ClickUp ワークスペース内のすべてのスペースを一覧表示します。スペース ID、名前、ステータスを返します。 |
clickup_list_folders | ClickUp スペース内のすべてのフォルダーを一覧表示します。スペース ID(例:「789」)を指定してください。フォルダー ID、名前、リスト数を返します。 |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します。
{
"mcpServers": {
"clickup": {
"url": "https://gateway.pipeworx.io/clickup/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/clickup/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール(ask_pipeworx、
discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できる一連のツール)も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールと合わせて、共通ツールが約 30 個表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認するための正式な情報源です。
これは意図的な設計であり、偶然に複数の機能を多重化しているわけではありません。メタツールを使うと、このパックでは扱えない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。
または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL も、同じゲートウェイと同じ 1875 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。
MCP クライアントがない場合:HTTP で呼び出す
このパックでは、ご自身の API キー(_apiKey)を使用します。こちらで API キーを用意していないため、API キーなしで実行できる curl の例はありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/clickup_list_tasks を使用してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用してください。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。
{
"mcpServers": {
"clickup": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-clickup"]
}
}
}
または、直接実行して起動することを確認できます。
npx -y @pipeworx/mcp-clickup
stdin/stdout 経由で MCP を使用し、initialize/tools/list/tools/call に対して、このパックのツールのみを提供します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。
ask_pipeworx の使用
ツールを直接呼び出す代わりに、自然な英語で質問できます。この機能は、上記のパックエンドポイントとフルゲートウェイの両方で利用できます。
ask_pipeworx({ question: "your question about Clickup data" })
ゲートウェイが適切なツールを選び、引数を自動的に設定します。
詳細情報
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。