MCP Server

🚧 Status Update: Major improvements in progress! I'm refactoring the codebase, bringing more optimization features and tools including a comprehensive caching system (based on automatic webhook integration), complete name-based lookups for all workspace resources, enhanced error handling, and more. See GitHub Issue #8 for details on what I'm currently working on.

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.

npx 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
Add under MCP Servers:

npx -y @taazkareem/clickup-mcp-server \
  --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

The server is also hosted on Smithery. There, you can preview the available tools or copy the commands to run on various clients.

Features

🎯 Task Management
- Create, update, and delete individual tasks
- Move and duplicate tasks between lists, spaces, and folders
- Create multiple tasks in bulk
- View and modify task details and properties
📂 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
🤖 AI-Powered Analysis
- Task status summaries and overviews
- Priority analysis and recommendations
- Structured description generation
- Task relationship mapping

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`
get_tasks	Get tasks from list	`listId`/`listName`
get_task	Get task details	`taskId`/`taskName`
delete_task	Remove task	`taskId`/`taskName`
move_task	Move task	`taskId`/`taskName`, `listId`/`listName`
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](docs/api-reference.md#folder-management) | Update folder properties | `folderId`/`folderName` |

See full documentation for optional parameters and advanced usage.

Available Prompts

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.

clickup-mcp-server

Categories

Language:

Stars:

Forks: