ClickUp MCP Server

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.

Category
Visit Server

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_taskssearch_tasks は最大10ページ(1000件)まで自動取得します。

配列パラメータ

search_tasksassigneesstatusestags は配列で渡せます。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

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

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.

Official
Featured
TypeScript
Kagi MCP Server

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.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured