ClickUp MCP Server

概要

このサーバーは、ClickUp APIとの連携を提供するMCP（Model Context Protocol）サーバーです。OAuth認証を通じて、ClickUpのワークスペース、タスク、時間追跡などを操作できます。

主な機能

ワークスペース管理

ClickUpのワークスペース、スペース、フォルダー、リストを取得できます

タスク管理

タスクの作成、更新、削除、取得ができます

時間追跡

時間追跡の開始、停止、エントリの管理ができます

ユーザー情報

認証されたユーザーの情報と自分のタスクを取得できます

エンドポイント

/sse - MCP通信用のMCPエンドポイント
/authorize - OAuth認証開始
/callback - OAuth認証コールバック
/webhook/clickup - ClickUp Webhookエンドポイント
/health - ヘルスチェック

使用方法

Claude Codeでの接続方法

以下の手順でClaude Codeに接続してください：

Claude Codeのターミナルで以下のコマンドを実行：
claude mcp add --transport sse clickup https://clickup-mcp.spookies.tech/sse
初回接続時にOAuth認証画面が表示されます
ClickUpアカウントでログインし、アプリケーションを承認してください
認証完了後、ClickUpのMCPツールが利用可能になります

利用可能なツール

ユーザー・ワークスペース: getUserInfo, getWorkspaces
階層構造: getSpaces, getFolders, getListsInFolder, getListsInSpace, getAllLists
タスク管理: getTasks, createTask, updateTask, deleteTask, getMyTasks
時間追跡: startTimeTracking, stopTimeTracking, getTimeEntries, createTimeEntry, updateTimeEntry, deleteTimeEntry
ユーティリティ: add (基本的な足し算テスト)

認証について

このサーバーはClickUpの標準的なOAuthスコープを使用します
ワークスペース、スペース、フォルダー、リスト、タスクへの読み書きアクセス権限を要求します
時間追跡エントリの作成・管理権限も含まれます
認証情報は安全に暗号化されて保存されます

使用例

Claude Codeで以下のような質問をしてみてください：

「私のワークスペースを教えて」
「今日のタスクを確認して」
「新しいタスクを作成して」
「時間追跡を開始して」
「プロジェクトのリストを全て取得して」

注意事項

セッションは一定時間後に自動的に期限切れとなります
Webhookは受信してログに記録しますが、リアルタイム通知はMCPエージェントが自動処理します
エラーが発生した場合は、ブラウザには適切なエラーページが、APIには詳細なエラーレスポンスが返されます