Clickup Integration Mcp Server

ClickUp MCP サーバー

Claude が ClickUp と連携してタスクを管理できるようにする Model Context Protocol（MCP）サーバーです。Claude Desktop で自然言語のプロンプトを使って、ClickUp のタスクを作成、更新、管理できます。

機能

• ClickUp の階層を移動：ワークスペース、スペース、フォルダー、リストを確認できます
• タスク管理：タスクの作成、読み取り、更新、削除ができます
• 高度なフィルタリング：ステータス、担当者、タグ、期限などでタスクを絞り込めます
• チームコラボレーション：タスクとリストのメンバーを確認できます
• 豊富なタスクプロパティ：説明、優先度、担当者、期限、タグ、カスタムフィールドに対応しています

利用可能なツール

ナビゲーションツール

• get_workspaces - アクセス可能な ClickUp ワークスペースをすべて一覧表示します
• get_spaces - ワークスペース内のスペースを取得します
• get_folders - スペース内のフォルダーを取得します
• get_lists - スペースまたはフォルダー内のリストを取得します

タスク管理ツール

• create_task - さまざまなプロパティを指定して新しいタスクを作成します
• get_task - 特定のタスクの詳細情報を取得します
• get_task_by_custom_id - カスタム ID（例：CUSTOM-123）を使ってタスクを取得します
• get_tasks - フィルタリングとページネーションを指定してタスクを一覧表示します（カスタム ID を含む）
• update_task - タスクのプロパティ（名前、ステータス、担当者など）を更新します
• update_task_by_custom_id - カスタム ID を使ってタスクを更新します
• delete_task - タスクを完全に削除します

メンバーツール

• get_task_members - タスクへのアクセス権を持つメンバーを取得します
• get_list_members - リストへのアクセス権を持つメンバーを取得します

インストール

前提条件

• Node.js 18 以降
• API にアクセスできる ClickUp アカウント
• Claude Desktop アプリ

1. クローンしてインストール

git clone <repository-url>
cd clickup-mcp
npm install

2. ClickUp API トークンを取得

1. ClickUp アカウントにログインします
2. 左下隅にあるプロフィール画像をクリックします
3. Settings を選択します
4. 左側のサイドバーで Apps をクリックします
5. API Token セクションまでスクロールします
6. Generate（すでにトークンがある場合は Regenerate）をクリックします
7. トークンをコピーします（pk_ で始まります）

重要：API トークンは安全に保管してください。バージョン管理に決してコミットしないでください。

3. 環境変数を設定

プロジェクトのルートに .env ファイルを作成します：

cp .env.example .env

.env を編集し、ClickUp API トークンを追加します：

CLICKUP_API_TOKEN=pk_your_actual_token_here

4. サーバーをビルド

npm run build

これにより、TypeScript コードが dist/ ディレクトリ内の JavaScript にコンパイルされます。

Claude Desktop での設定

Windows

1. Claude Desktop の設定ファイルを開きます：

   %AppData%\Claude\claude_desktop_config.json
   

2. ClickUp MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["C:\Users\username\Documents\clickup-updater\clickup-mcp\dist\index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_actual_token_here"
      }
    }
  }
}

注：パスを実際のインストール先に置き換えてください。Windows のパスでは、バックスラッシュを二重に（\\）してください。

macOS/Linux

1. Claude Desktop の設定ファイルを開きます：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

2. ClickUp MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/absolute/path/to/clickup-mcp/dist/index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_actual_token_here"
      }
    }
  }
}

5. Claude Desktop を再起動

設定を更新した後、Claude Desktop を再起動して MCP サーバーを読み込みます。

使用例

設定が完了すると、Claude で自然言語のプロンプトを使って ClickUp を操作できます：

ナビゲーション

"Show me all my ClickUp workspaces"

"List the spaces in workspace 12345"

"What lists are in the Marketing space?"

タスクの作成

"Create a task called 'Review Q1 metrics' in the Marketing Reports list"

"Create a high-priority task for the website redesign project with John and Sarah assigned"

"Add a task 'Update documentation' with a due date of next Friday"

タスク管理

"Show me all tasks in the Development list"

"Get details for task abc123"

"Get task CUSTOM-123"

"Update task xyz789 to mark it as complete"

"Update task PROJ-456 to change its status to In Progress"

"Change the priority of task abc123 to urgent"

"Find all tasks assigned to me that are overdue"

カスタム ID の操作

カスタム ID はワークスペース固有の識別子（例：CUSTOM-123、PROJ-456）で、ClickUp 内部のタスク ID の代わりに使用できます：

"Get the task with custom ID CUSTOM-123"

"Update PROJ-456 and change the status to Complete"

"Show me the details of task MARKETING-789"

チームコラボレーション

"Who has access to task abc123?"

"Show me all members of the Development list"

開発

プロジェクト構成

clickup-mcp/
├── src/
│   ├── index.ts              # Entry point with STDIO transport
│   ├── server.ts             # MCP server setup and tool registration
│   ├── types/
│   │   └── clickup.ts        # ClickUp API type definitions
│   ├── utils/
│   │   ├── clickup-client.ts # ClickUp API wrapper
│   │   └── error-handler.ts  # Error handling utilities
│   └── tools/
│       ├── navigation.ts     # Navigation tools
│       └── tasks.ts          # Task management tools
├── dist/                     # Compiled JavaScript (generated)
├── .env                      # Environment variables (not committed)
├── .env.example              # Environment template
├── package.json              # Dependencies and scripts
├── tsconfig.json             # TypeScript configuration
└── README.md                 # This file

利用可能なスクリプト

• npm run build - TypeScript を JavaScript にコンパイルします
• npm run watch - 開発用のウォッチモードを実行します
• npm run dev - サーバーをビルドしてローカルで実行します

新しいツールの追加

1. src/tools/ 内の該当するファイルにツールの実装を追加します
2. server.registerTool() を使ってツールをツールファイルに登録します
3. 必要に応じて src/types/clickup.ts の型定義を更新します
4. src/utils/clickup-client.ts に新しい API クライアントメソッドを追加します
5. npm run build で再ビルドします

トラブルシューティング

認証エラー

認証エラーが表示される場合：

• API トークンが正しく、pk_ で始まっていることを確認してください
• トークンが .env ファイルまたは Claude Desktop の設定に正しく設定されていることを確認してください
• ClickUp の設定でトークンが取り消されていないことを確認してください

接続の問題

Claude Desktop がサーバーに接続できない場合：

• claude_desktop_config.json のパスが正しいことを確認してください
• サーバーが正常にビルドされたことを確認してください（npm run build）
• Claude Desktop のログでエラーを確認してください
• 設定を変更した後、Claude Desktop を再起動してください

レート制限

ClickUp API にはレート制限があります。制限に達した場合：

• 追加のリクエストを行う前に、しばらくお待ちください
• サーバーはレート制限に関する明確なエラーメッセージを表示します

API リファレンス

ClickUp API の詳細については、以下をご覧ください：

• ClickUp API ドキュメント
• ClickUp API 認証

ライセンス

MIT

貢献者

貢献者	役割
ChrisNoronha	作成者兼メンテナー
Claude Code (Anthropic)	AI コラボレーター — 設計、実装、ドキュメント作成を支援

コントリビューション

コントリビューションを歓迎します！お気軽にイシューやプルリクエストを送信してください。