The ClickUp MCP Server enables AI-powered task management by interfacing with ClickUp's API, focusing on core workflows while excluding advanced features.
Task Management (CRUD): Create, read, update, and delete tasks with flexible ID support (standard IDs, custom patterns, URLs, hashes)
Task Organization & Navigation: Navigate and manage tasks across spaces, folders, and lists
Task Search & Filtering: Find tasks by text queries or filter by criteria like statuses and assignees
Comments & Collaboration: Read existing and create new comments on tasks
User & Assignment Management: List users, find users by name/email, and manage task assignees
Status Management: Update and track task statuses
Bulk Operations: Update or move multiple tasks simultaneously
Time Tracking: Log time entries and view tracked hours for tasks/users
Task Templates: Create tasks from predefined templates with customization options
Task Chains: Create sequences of dependent tasks
Team Analytics: View workload distribution and completion metrics
Enables interaction with ClickUp's task management API, providing tools for creating, reading, updating, and deleting tasks, managing task organization, searching and filtering tasks, handling assignees and statuses, performing bulk operations, tracking time, and generating team analytics.
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)
Development Installation
Configuration
API Key Setup
Getting Your ClickUp API Key
Step-by-step instructions:
Log in to ClickUp at https://app.clickup.com
Navigate to Settings:
Click your avatar/profile picture in the bottom left corner
Select "Settings" from the dropdown menu
Go to Apps section:
In the left sidebar, click "Apps"
Then click "API" (or go directly to https://app.clickup.com/settings/apps)
Generate API Token:
Click the "Generate" button to create a new personal API token
Important: This token will only be shown once!
Copy and Save:
Copy the generated token immediately
Store it securely (password manager recommended)
Configure it using:
uvx clickup-mcp set-api-key YOUR_TOKEN_HERE
Important Notes:
Personal API tokens have the same permissions as your user account
Keep your token secure - treat it like a password
If you lose the token, you'll need to regenerate a new one
Tokens don't expire but can be revoked in the same settings page
Usage with AI Assistants
Claude Code (CLI)
Add to ~/.config/claude-code/mcp-settings.json
:
Claude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
VS Code
VS Code has excellent MCP support through both native integration and extensions. Multiple setup options available:
Option 1: Native VS Code MCP (Recommended)
VS Code now has built-in MCP support with GitHub Copilot and Agent Mode. Add to your workspace:
Create
Or add to VS Code User Settings:
Open Command Palette (
Ctrl+Shift+P
/Cmd+Shift+P
)Run "Preferences: Open User Settings (JSON)"
Add to settings:
Option 2: VS Code Extensions with MCP Support
Copilot MCP Extension:
Install "Copilot MCP" from VS Code Marketplace
Search, manage, and install MCP servers directly from VS Code
The extension will help you configure the ClickUp MCP server
Cline (AI Coding Assistant):
Install "Cline" extension for advanced AI coding with MCP support
Configure ClickUp MCP server through Cline's settings
Managing MCP Servers in VS Code
Open Command Palette (
Ctrl+Shift+P
/Cmd+Shift+P
)Run "MCP: List Servers" to view configured servers
Select ClickUp server to Start/Stop/Restart or view logs
Use "MCP: Show Output" for debugging
Verify VS Code Setup
Ensure your ClickUp API key is configured:
uvx clickup-mcp set-api-key YOUR_KEY
In VS Code, ask GitHub Copilot: "Can you list my ClickUp spaces using MCP tools?"
Check MCP server status with Command Palette → "MCP: List Servers"
Available Tools (28 Tools)
📝 Task Management
create_task
- Create new tasksget_task
- Get task details (supports various ID formats)update_task
- Update task propertiesdelete_task
- Delete taskscreate_task_from_template
- Create from predefined templatescreate_task_chain
- Create dependent task sequences
🔍 Task Discovery
list_tasks
- List tasks with filtering optionssearch_tasks
- Search tasks by text and criteriaget_subtasks
- Get all subtasks of a parentget_task_comments
- Get comments on taskscreate_task_comment
- Create comments on tasks
👥 Assignment & Status
get_task_status
- Get current task statusupdate_task_status
- Change task statusget_assignees
- List task assigneesassign_task
- Assign users to tasks
🗂️ Navigation
list_spaces
- List all spaces in workspacelist_folders
- List folders in a spacelist_lists
- List all listsfind_list_by_name
- Find lists by name
⚡ Bulk Operations
bulk_update_tasks
- Update multiple tasks at oncebulk_move_tasks
- Move multiple tasks to different lists
⏱️ Time Tracking
get_time_tracked
- Get time tracked for users/periodslog_time
- Log time spent on tasks
📊 Analytics
get_team_workload
- See task distribution across team membersget_task_analytics
- Get velocity metrics and completion rates
👤 User Management
list_users
- List all users in workspaceget_current_user
- Get current authenticated user detailsfind_user_by_name
- Find users by name or email
Example Usage
Natural Language Commands
Ask your AI assistant:
Task Templates
Analytics Queries
Development
Running Tests
Code Quality
Troubleshooting
Check Configuration
Debug Mode
Local Testing with Claude Code
Technical Limitations
Rate Limiting: No built-in rate limiting (ClickUp: 100 req/min)
Pagination: Limited pagination support
Caching: No response caching implemented
Custom Fields: Models exist but limited tool support
Error Recovery: Basic error handling without sophisticated retry
Contributing
We welcome contributions! Focus areas:
Priority Improvements
Enhanced error handling and retry logic
Response caching implementation
Better pagination support
Expanded custom field support
How to Contribute
Fork the repository
Create a feature branch (
git checkout -b feature/improvement
)Make changes and add tests
Ensure all tests pass (
uv run pytest
)Run linting (
uv run ruff check .
)Submit a Pull Request
Development Setup
Support
Issues: GitHub Issues
Discussions: GitHub Discussions
Email: tech@diversio.com
License
MIT License - see LICENSE file for details.
Acknowledgments
Built by Diversio team
Powered by Model Context Protocol
Uses ClickUp API v2
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.
- 🚀 What This Server Provides
- Installation
- Configuration
- Usage with AI Assistants
- Available Tools (28 Tools)
- Example Usage
- Development
- Troubleshooting
- Technical Limitations
- Contributing
- Support
- License
- Acknowledgments
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.Last updated -1315MIT License
- AsecurityAlicenseAqualityEnables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.Last updated -1,703403MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -1,7032MIT License
- AsecurityFlicenseAqualityProvides tools for AI assistants to interact with the Dida365 (TickTick) task management API, allowing management of tasks and projects after user authorization.Last updated -522