Labsco
DiversioTeam logo

ClickUp

★ 3

from DiversioTeam

Interact with ClickUp's task management API to manage projects and tasks through natural language.

🔥🔥🔥✓ VerifiedFreeNeeds API keys
#email#automation#calendar#analytics#payments#documents#git#project-mgmt

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.

ClickUp Server MCP server

🚀 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.

Available Tools (28 Tools)

📝 Task Management

  • create_task - Create new tasks
  • get_task - Get task details (supports various ID formats)
  • update_task - Update task properties
  • delete_task - Delete tasks
  • create_task_from_template - Create from predefined templates
  • create_task_chain - Create dependent task sequences

🔍 Task Discovery

  • list_tasks - List tasks with filtering options
  • search_tasks - Search tasks by text and criteria
  • get_subtasks - Get all subtasks of a parent
  • get_task_comments - Get comments on tasks
  • create_task_comment - Create comments on tasks

👥 Assignment & Status

  • get_task_status - Get current task status
  • update_task_status - Change task status
  • get_assignees - List task assignees
  • assign_task - Assign users to tasks
  • list_spaces - List all spaces in workspace
  • list_folders - List folders in a space
  • list_lists - List all lists
  • find_list_by_name - Find lists by name

⚡ Bulk Operations

  • bulk_update_tasks - Update multiple tasks at once
  • bulk_move_tasks - Move multiple tasks to different lists

⏱️ Time Tracking

  • get_time_tracked - Get time tracked for users/periods
  • log_time - Log time spent on tasks

📊 Analytics

  • get_team_workload - See task distribution across team members
  • get_task_analytics - Get velocity metrics and completion rates

👤 User Management

  • list_users - List all users in workspace
  • get_current_user - Get current authenticated user details
  • find_user_by_name - Find users by name or email

Development

Running Tests

# Run all tests (62 tests)
uv run pytest

# Run with coverage
uv run pytest --cov=clickup_mcp

# Run specific test
uv run pytest tests/test_client.py::test_create_task

Code Quality

# Check code style
uv run ruff check .

# Format code
uv run ruff format .

# Type checking
uv run mypy src/

Support