ClickUp MCP Server

ClickUpタスクをAIアプリケーションと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIエージェントは標準化されたプロトコルを介してClickUpタスク、スペース、リスト、フォルダーと対話できるようになります。

🚀**ステータス更新:**完全な時間追跡サポートとドキュメント管理機能を備えた v0.7.2 が利用可能になりました。

設定

1. 資格情報を取得します:
   • ClickUp設定からのClickUp APIキー
   • ClickUpワークスペースURLからのチームID
2. ホスト型インストール（Webhook を送信）または NPX インストール（ローカル パスにダウンロードして依存関係をインストール）のいずれかを選択します。
3. 自然言語を使用してワークスペースを管理しましょう。

Smithery のインストール (クイック スタート)

サーバーはSmitheryでホストされています。そこでは、利用可能なツールをプレビューしたり、特定のクライアントアプリで実行するコマンドをコピーしたりできます。

NPXのインストール

クライアントの MCP 設定 JSON ファイルに次のエントリを追加します。

または、次の npx コマンドを使用します。

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

注意: 「DOCUMENT_SUPPORT」に「true」を渡さない場合、デフォルトは false となり、ドキュメント サポートはアクティブになりません。

さらに、 DISABLED_TOOLS環境変数または--env DISABLED_TOOLS引数を使用して、特定のツールを無効にすることもできます。無効にするツール名をカンマ区切りのリストで指定してください（例： create_task,delete_task ）。

ツールの数やコンテキストの制限に問題がある場合は、不要なツールを無効にしてください。

SSEサポートで実行

次の環境変数を設定することにより、サーバーを SSE (Server-Sent Events) モードで実行できます。

またはコマンドラインから:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Docker-compose の例

特徴

利用可能なツール

オプションのパラメータと高度な使用法については、完全なドキュメントを参照してください。

会員管理ツール

タスク作成時に、 assigneesパラメータを使ってユーザーを割り当てることができるようになりました。このパラメータは、ユーザーID、メールアドレス、またはユーザー名の配列を受け入れます。

メンバー管理ツールは、必要に応じてユーザー参照を解決するのに役立ちます。

プロンプト

まだ実装されておらず、すべてのクライアントアプリでサポートされているわけではありません。ワークフローに最も役立つと思われるPromptの実装機能をリクエストしてください（具体的な内容は問いません）。例：

エラー処理

サーバーは、次の場合に明確なエラー メッセージを提供します。

• 必要なパラメータが不足しています
• 無効なIDまたは名前
• アイテムが見つかりません
• 権限の問題
• APIエラー
• レート制限

LOG_LEVEL環境変数を指定することで、サーバーログの詳細度を制御できます。有効な値は、 trace 、 debug 、 info 、 warn 、 error （デフォルト）です。これはコマンドラインでも指定できます（例： --env LOG_LEVEL=info ）。

開発者をサポートする

このサーバーをご利用の際に、ツールのレスポンスにこのリポジトリへのリンクを含む小さなスポンサーメッセージが表示されることがあります。プロジェクトへのご支援をお待ちしております。このプロジェクトが役に立つと思われましたら、ぜひご支援ください。

謝辞

この統合を可能にした優れた API とサービスについて、 ClickUpに特に感謝します。

貢献

貢献を歓迎します！詳細については貢献ガイドをご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

免責事項

本ソフトウェアはサードパーティのAPIを利用しており、サードパーティが所有する商標またはブランドを参照する場合があります。これらのAPIまたは参照の使用は、各企業との提携または推奨を意味するものではありません。すべての商標およびブランド名はそれぞれの所有者の財産です。本プロジェクトは独立した作品であり、言及されているいかなるサードパーティ企業とも公式に提携またはスポンサー契約を結んでいません。