ClickUp MCP Server

ClickUp のタスク管理を行う MCP (Model Context Protocol) サーバーです。

ClickUp API v2 を使用して、タスクの検索・作成・更新・削除、ワークスペース情報の取得、コメントの管理ができます。

提供ツール（15個）

ワークスペース

ツール名	説明
get_teams	チーム（ワークスペース）一覧を取得
get_spaces	スペース一覧を取得
get_folders	フォルダー一覧を取得
get_lists	スペース直下のリスト一覧を取得
get_folder_lists	フォルダー内のリスト一覧を取得

タスク管理

ツール名	説明
create_task	タスクを作成（担当者・タグ・優先度・日時指定可）
get_tasks	リスト内のタスク一覧を取得（自動ページネーション）
get_task_detail	タスクの詳細情報を取得
update_task	タスクの各フィールドを更新（汎用）
update_task_status	タスクのステータスを更新
delete_task	タスクを削除

検索・分析

ツール名	説明
search_tasks	高度な検索（ステータス・担当者・タグ・日付フィルタ）
get_weekly_summary	ステータス別タスクサマリーを取得

コメント

ツール名	説明
add_comment	タスクにコメントを追加
get_task_comments	タスクのコメント一覧を取得

セットアップ

1. ClickUp API キーの取得

ClickUp Settings > Apps で API キーを取得してください。

2. MCP クライアントに設定

Claude Desktop

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}

Claude Code

プロジェクトルートの .mcp.json またはCLIで追加:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}

ローカルで実行する場合

git clone https://github.com/yourname/clickup-mcp.git
cd clickup-mcp
npm install
npm run build

MCP クライアント設定:

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp/build/index.js"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}

主な機能

自動ページネーション

get_tasks と search_tasks は最大10ページ（1000件）まで自動取得します。

配列パラメータ

search_tasks の assignees、statuses、tags は配列で渡せます。ClickUp API が要求する key[] 形式に自動変換されます。

日時の柔軟なパース

日時パラメータは以下の形式に対応しています:

• 2026-02-19（日付のみ）
• 2026-02-19T14:30（ISO形式）
• 2026-02-19 14:30:00（スペース区切り）
• 2026/02/19（スラッシュ区切り）

環境変数

変数名	必須	デフォルト	説明
CLICKUP_API_KEY	Yes	—	ClickUp API キー
CLICKUP_TEAM_ID	Yes	—	チーム（ワークスペース）ID
CLICKUP_DEFAULT_LIST_ID	No	—	デフォルトリストID

ライセンス

MIT