Overview
What is clickup-mcp-server?
A Model Context Protocol server for ClickUp API interaction and automation, enabling AI systems like Claude to read, create, and update tasks, lists, and spaces in ClickUp workspaces.
How to use clickup-mcp-server?
Install via pip install clickup-mcp-server or run directly with uvx clickup-mcp-server. Provide your ClickUp API key as a command-line argument (--api-key) or in a .env file (CLICKUP_API_KEY). Configure the server in Claude Desktop, VS Code, or Zed using the provided JSON snippets.
Key features of clickup-mcp-server
- Create, update, delete, move, and duplicate tasks
- Bulk update and bulk delete tasks
- Manage subtasks, comments, and attachments
- Navigate and manage workspaces, spaces, folders, and lists
- Full markdown support with HTML conversion for descriptions
- Comprehensive error handling and clear API responses
Use cases of clickup-mcp-server
- Automate task creation and status updates across multiple lists
- Bulk assign, tag, or update due dates for project milestones
- Navigate and reorganize workspace hierarchy (spaces, folders, lists)
- Generate project summaries with task details and comments
- Integrate AI assistants into ClickUp workflows for project management
FAQ from clickup-mcp-server
What are the prerequisites?
Python 3.10 or higher and a ClickUp account with an API key.
How do I get a ClickUp API key?
Obtain it from the ClickUp API Settings page at https://app.clickup.com/settings/apps.
How do I run clickup-mcp-server?
Use uvx clickup-mcp-server --api-key YOUR_API_KEY or after pip installation, run python -m clickup_mcp_server --api-key YOUR_API_KEY.
Can I use it with Claude Desktop?
Yes, add a configuration entry to claude_desktop_config.json using uvx, docker, or the pip-installed module as shown in the README.
Does it support bulk operations?
Yes, it provides bulk_update_tasks and bulk_delete_tasks tools for updating or deleting multiple tasks at once.
