ClickUp MCP Server
MCP server for ClickUp task management, enabling task search, creation, update, deletion, workspace info retrieval, and comment management via ClickUp API v2.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.