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 buildMCP クライアント設定:
{
"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
