diversioteam/clickup-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

5 stars 4 forks 质量 71 趋势 13MIT

Repository Install

A Model Context Protocol (MCP) server that enables AI assistants to interact with ClickUp's task management API.

概览

A Model Context Protocol (MCP) server that enables AI assistants to interact with ClickUp's task management API. This server provides comprehensive task management capabilities through natural language, focusing on essential project workflows rather than ClickUp's full feature set. Built by the Diversio team for streamlined AI-powered task management. - - Create, read, update, and delete tasks - - Navigate spaces, folders, and lists - - Find tasks by various criteria - - Read and create comments on tasks - - List users, find by name/email, assign to tasks - - Update and track task statuses - - Update or move multiple tasks at once - - Log time and view tracked hours - - Create tasks from predefined templates (bug report, feature request, code review) - - Create sequences of dependent tasks - - View workload distribution and completion metrics - Standard ClickUp IDs (abc123) - Custom ID patterns (gh-123, bug-456) - ClickUp URLs (https://app.clickup.

README

以下为原文 README 节选，完整内容请查看原文。

ClickUp MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with ClickUp’s task management API. This server provides comprehensive task management capabilities through natural language, focusing on essential project workflows rather than ClickUp’s full feature set.

Built by the Diversio team for streamlined AI-powered task management.

🚀 What This Server Provides

✅ Core Task Management

Task CRUD Operations - Create, read, update, and delete tasks
Task Organization - Navigate spaces, folders, and lists
Task Search & Filtering - Find tasks by various criteria
Comments & Collaboration - Read and create comments on tasks
User & Assignment Management - List users, find by name/email, assign to tasks
Status Management - Update and track task statuses

✅ Productivity Features

Bulk Operations - Update or move multiple tasks at once
Time Tracking - Log time and view tracked hours
Task Templates - Create tasks from predefined templates (bug report, feature request, code review)
Task Chains - Create sequences of dependent tasks
Team Analytics - View workload distribution and completion metrics

✅ Flexible ID Support

Standard ClickUp IDs (abc123)
Custom ID patterns (gh-123, bug-456)
ClickUp URLs (https://app.clickup.com/t/abc123)
Hash format (#123)

❌ What’s NOT Included

This server focuses on task management essentials. Not supported:

ClickUp Docs/Documents
Whiteboards
Dashboards
Automations/Workflows
Goals/Targets
File/Attachment management
Webhook management
Advanced custom field operations
Calendar views
Forms integration

API Coverage: ~30-40% of ClickUp’s full API, covering the most common task management workflows.

Installation

Quick Start (Recommended)

# Install from GitHub (latest)
uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp

# Or from PyPI (when published)
uvx clickup-mcp

Development Installation

git clone https://github.com/DiversioTeam/clickup-mcp
cd clickup-mcp
uv sync
uv run clickup-mcp

Configuration

API Key Setup

# Set your ClickUp API key

在 GitHub 查看完整 README

安装

uvx --from git+https://github.com/DiversioTeam/clickup-mcp.git clickup-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "clickup": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"]
    }
  }
}