MIT
ClickUp MCP Server
by ttttdiva
Provides tools for managing ClickUp tasks, workspaces, and comments via the ClickUp API v2, including task search, creation, update, deletion, workspace info retrieval, and comment management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ClickUp MCP Server Create a task 'Write report' due 2026-03-01 in the 'Work' list."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ClickUp MCP Server
ClickUp のタスク管理を行う MCP (Model Context Protocol) サーバーです。
ClickUp API v2 を使用して、タスクの検索・作成・更新・削除、ワークスペース情報の取得、コメントの管理ができます。
提供ツール（15個）
ワークスペース
ツール名 | 説明 |
| チーム（ワークスペース）一覧を取得 |
| スペース一覧を取得 |
| フォルダー一覧を取得 |
| スペース直下のリスト一覧を取得 |
| フォルダー内のリスト一覧を取得 |
タスク管理
ツール名 | 説明 |
| タスクを作成（担当者・タグ・優先度・日時指定可） |
| リスト内のタスク一覧を取得（自動ページネーション） |
| タスクの詳細情報を取得 |
| タスクの各フィールドを更新（汎用） |
| タスクのステータスを更新 |
| タスクを削除 |
検索・分析
ツール名 | 説明 |
| 高度な検索（ステータス・担当者・タグ・日付フィルタ） |
| ステータス別タスクサマリーを取得 |
コメント
ツール名 | 説明 |
| タスクにコメントを追加 |
| タスクのコメント一覧を取得 |
Related MCP server: ClickUp MCP Server
セットアップ
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（スラッシュ区切り）
環境変数
変数名 | 必須 | デフォルト | 説明 |
| Yes | — | ClickUp API キー |
| Yes | — | チーム（ワークスペース）ID |
| No | — | デフォルトリストID |
ライセンス
MIT
Available Tools
15 toolsadd_commentC
タスクにコメントを追加します。
Inputs: task_id (required), comment_text (required).
create_taskC
ClickUpでタスクを作成します。
Inputs: name (required), tags, list_id, due_date, +6 more.
delete_taskA
タスクを削除します（この操作は取り消せません）。
Inputs: task_id (required).
get_folder_listsB
フォルダー内のリスト一覧を取得します。
Inputs: folder_id (required).
get_foldersA
スペース内のフォルダー一覧を取得します。
Inputs: space_id (required).
get_listsA
スペース内のフォルダーに属さないリスト一覧を取得します。
Inputs: space_id (required).
get_spacesB
チーム内のスペース一覧を取得します。
Inputs: team_id.
get_task_commentsB
タスクのコメント一覧を取得します。
Inputs: task_id (required).
get_task_detailB
タスクの詳細情報を取得します。
Inputs: task_id (required).
get_tasksC
リスト内のタスク一覧を取得します。
Inputs: list_id, include_closed, exclude_no_start_date.
get_teamsA
ClickUpのチーム（ワークスペース）一覧を取得します。
Inputs: no named parameters.
get_weekly_summaryC
タスクサマリーをAPIから取得します。
Inputs: no named parameters.
search_tasksD
タスクを検索します。
Inputs: tags, query, team_id, statuses, +5 more.
update_taskC
タスクの各フィールドを更新します（汎用更新）。
Inputs: task_id (required), name, status, due_date, +7 more.
update_task_statusB
タスクのステータスを更新します。
Inputs: status (required), task_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
B3/5.0
Scored across 15 tools
Disambiguation3/5
Some tools have overlapping purposes, such as update_task and update_task_status, and get_lists vs get_folder_lists. While descriptions clarify the differences, an agent could still misselect between the generic update and specialized status update, or between the two list retrieval methods.
Naming Consistency5/5
All tools follow a consistent verb_noun pattern using snake_case (e.g., get_teams, create_task, update_task_status, delete_task). The naming is predictable and uniform across the entire set.
Tool Count5/5
With 15 tools, the server is well-scoped for a project management MCP. It covers the essential operations without being bloated, fitting comfortably within the ideal 3-15 range.
Completeness3/5
Task lifecycle is well covered (create, read, update, delete, search, comments), but the broader workspace hierarchy (teams, spaces, folders, lists) is read-only with no create/update/delete operations. This limits the server to task-centric workflows rather than full workspace management.
Maintenance
ActivityInactive
ResponsivenessOutdated data
Related MCP Connectors
Unofficial community ClickUp MCP via personal API token. Not affiliated with ClickUp.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ClickUp MCP — wraps the ClickUp REST API v2 (BYO API key)
Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides integration with ClickUp's API, allowing you to retrieve task information and manage ClickUp data through MCP-compatible clients.-
- AlicenseNot gradedqualityBmaintenanceMCP server enabling AI assistants to interact with ClickUp workspaces, including task management, comments, time tracking, and document operations.85 npmMIT
- AlicenseNot gradedqualityDmaintenanceA secure and optimized MCP server for integrating ClickUp project management, enabling task CRUD operations, workspace organization, file attachments, and natural language date parsing.MIT