clickup mcp server

Local 2025-08-31 23:48:50 0

Developer Tools @windalfin/clickup-mcp-server

A Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.

A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.

? Status Update: -The code refactoring has been completed. -Enhanced due date functionality now supports relative time expressions like "2 hours from now" with proper time display in ClickUp. -npx command updated to use @latest which should automatically update the server when a new version is released. -Server has been listed on Smithery, Glama, and Pulse MCP.

Quick Start

Directions for use with Cursor Composer Agent:

Get your credentials:
ClickUp API key from ClickUp Settings
Team ID from your ClickUp workspace URL
Go to Features in settings (or MCP Servers depending on version)

Add under MCP Servers:

npx -y @taazkareem/clickup-mcp-server@latest 
  --env CLICKUP_API_KEY=your_api_key_here 
  --env CLICKUP_TEAM_ID=your_team_id_here

Replace the credentials and click Save
Use Natural Language to interact with your ClickUp Workspace!

Smithery Installation

The server is also hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app.

Features

? Task Management
Create, update, and delete individual tasks
Move and duplicate tasks between lists, spaces, and folders
Create, update, move,and delete multiple tasks in bulk
View and modify task details and properties
Set due dates using natural language and relative time expressions
? Workspace Organization
Complete workspace hierarchy (spaces, folders, lists)
Tree structure with clear relationships
Full CRUD operations for workspace components
Efficient path-based navigation
? Integration Features
Name or ID-based item lookup
Case-insensitive name matching
Markdown formatting support
Built-in API rate limiting

Available Tools

Tool	Description	Required Parameters
get_workspace_hierarchy	Get workspace structure	None
create_task	Create a task	`name`, (`listId`/`listName`)
create_bulk_tasks	Create multiple tasks	`tasks[]`
update_task	Modify task	`taskId`/`taskName`
update_bulk_tasks	Update multiple tasks	`tasks[]` with IDs or names
get_tasks	Get tasks from list	`listId`/`listName`
get_task	Get task details	`taskId`/`taskName`
delete_task	Remove task	`taskId`/`taskName`
delete_bulk_tasks	Remove multiple tasks	`tasks[]` with IDs or names
move_task	Move task	`taskId`/`taskName`, `listId`/`listName`
move_bulk_tasks	Move multiple tasks	`tasks[]` with IDs or names, target list
duplicate_task	Copy task	`taskId`/`taskName`, `listId`/`listName`
create_list	Create list in space	`name`, `spaceId`/`spaceName`
create_folder	Create folder	`name`, `spaceId`/`spaceName`
create_list_in_folder	Create list in folder	`name`, `folderId`/`folderName`
get_folder	Get folder details	`folderId`/`folderName`
update_folder	Update folder properties	`folderId`/`folderName`
delete_folder	Delete folder	`folderId`/`folderName`
get_list	Get list details	`listId`/`listName`
update_list	Update list properties	`listId`/`listName`
delete_list	Delete list	`listId`/`listName`

See full documentation for optional parameters and advanced usage.

Available Prompts

Not yet implemented (or needed) For now, you can send a follow up prompt after the tool result.

Prompt	Purpose	Features
summarize_tasks	Task overview	Status summary, priorities, relationships
analyze_priorities	Priority optimization	Distribution analysis, sequencing
generate_description	Task description creation	Objectives, criteria, dependencies

Error Handling

The server provides clear error messages for: - Missing required parameters - Invalid IDs or names - Items not found - Permission issues - API errors - Rate limiting

Support the Developer

If you find this project useful, please consider supporting

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

Disclaimer: This software makes use of third-party APIs and may reference trademarks or brands owned by third parties. The use of such APIs or references does not imply any affiliation with or endorsement by the respective companies. All trademarks and brand names are the property of their respective owners. This project is an independent work and is not officially associated with or sponsored by any third-party company mentioned.