Model Context Protocol (MCP) Server for ClickUp

This specialized MCP server bridges the gap between advanced AI agents and the ClickUp platform, offering a unified protocol for managing project artifacts. It exposes ClickUp elements—tasks, spaces, organizing folders, and item lists—to AI tooling via structured communication.

🚧 Development Log: -Internal code structure has undergone comprehensive modernization. -Enhanced capability for processing temporal directives (e.g., "in 90 minutes") for due date setting, ensuring accurate time reflection in ClickUp records. -The deployment utility (npx) is now anchored to the @latest tag for automatic dependency updates. -The server has been officially registered across leading MCP registries: Smithery, Glama, and Pulse.

Initiation Sequence

Instructions for integration with the Cursor Composer Agent framework:

1. Acquire necessary access tokens:
2. Your unique ClickUp Authorization Key, obtainable from the ClickUp Application Settings console.
3. The Workspace Identifier (Team ID) retrieved from your primary ClickUp URL path.
4. Navigate to System Settings, specifically the 'Features' section (or 'MCP Endpoints' based on software iteration).

5. Register the new endpoint under MCP Servers using this command: bash npx -y @taazkareem/clickup-mcp-server@latest \ --env CLICKUP_API_KEY=your_secret_api_key_here \ --env CLICKUP_TEAM_ID=your_workspace_identifier_here

6. Substitute placeholders with your actual credentials and confirm the configuration save.

7. Commence operational interaction using intuitive, everyday language to manipulate your ClickUp environment!

Smithery Registry Link

This service is also discoverable on the Smithery repository, allowing pre-deployment inspection of exposed functionalities or direct command copying for client applications.

Core Capabilities

• 🎯 Item Lifecycle Management
• Creation, modification, and archival of discrete work items.
• Reassignment and duplication of tasks across distinct lists, containment folders, and primary spaces.
• Batch processing for creation, modification, and removal of multiple items concurrently.
• Inspection and refinement of task attributes and metadata.

• Dynamic scheduling capability utilizing natural temporal phrasing for deadline assignment.

• 📂 Hierarchical Structure Control

• Comprehensive manipulation across the entire workspace domain (spaces, containment folders, task lists).
• Support for traversing and managing defined structural relationships.
• Full Create/Read/Update/Delete operations for all organizational units.

• Optimized navigation based on location paths.

• 🔄 Interoperability Enhancements

• Retrieval mechanisms supporting both unique identifiers (IDs) and descriptive labels (Names).
• Robust matching logic, including tolerance for case variance in names.
• Native support for Markdown formatting within textual fields.
• Integrated mechanisms for throttling API requests to respect external service limits.

Exposed Functions (Tools)

Function Signature	Operational Summary	Mandatory Inputs
get_workspace_hierarchy	Retrieve overall structure map	None
create_task	Instantiate a new work item	name, (listId/listName)
create_bulk_tasks	Provision several items at once	tasks[]
update_task	Edit attributes of an existing item	taskId/taskName
update_bulk_tasks	Modify attributes for a set of items	tasks[] (identifiers required)
get_tasks	Fetch items residing in a specific list	listId/listName
get_task	Retrieve detailed specifications for one item	taskId/taskName
delete_task	Permanently retire a single task	taskId/taskName
delete_bulk_tasks	Execute mass item removal	tasks[] (identifiers required)
move_task	Relocate an item to a different list	taskId/taskName, listId/listName
move_bulk_tasks	Relocate multiple items en masse	tasks[] (identifiers), destination list
duplicate_task	Generate an exact copy of an item	taskId/taskName, listId/listName
create_list	Establish a new task list within a space	name, spaceId/spaceName
create_folder	Establish a new container folder	name, spaceId/spaceName
create_list_in_folder	Establish a new list nested inside a folder	name, folderId/folderName
get_folder	Retrieve metadata for a folder	folderId/folderName
update_folder	Revise the properties of a folder	folderId/folderName
delete_folder	Archive a specified folder structure	folderId/folderName
get_list	Retrieve metadata for a list	listId/listName
update_list	Revise the properties of a list	listId/listName
delete_list	Archive a specified task list	listId/listName

Consult the comprehensive reference guide for optional parameters and advanced operational methods.

Consequential Prompts

Currently, this component relies on external prompting mechanisms post-tool execution. Subsequent, context-aware queries are recommended.

Prompt Utility	Primary Objective	Key Functionality
summarize_tasks	Obtain high-level work item synopsis	Status roll-up, priority aggregation, dependency mapping
analyze_priorities	Suggest optimal sequencing of efforts	Distribution profiling, recommended execution order
generate_description	Autonomously compose item narratives	Defining objectives, success criteria, prerequisite tasks

Exception Handling Protocols

The server provides explicit diagnostics for the following failure modes: - Omission of mandatory input parameters. - Use of non-existent identifiers or names. - Failure to locate a referenced organizational unit or item. - Access denial due to insufficient user permissions. - Failures originating from the upstream ClickUp API. - Exceeding defined API request velocity thresholds.

Developer Patronage

If this integration proves valuable to your operational efficiency, support for the creator is welcomed:

Collaborative Contributions

Contributions are encouraged! Refer to the Contribution Guidelines for submission prerequisites.

Licensing Framework

This software is distributed under the terms of the MIT License; review the LICENSE file for full particulars.

Liability Statement

Advisory: This solution interfaces with third-party APIs and may reference proprietary trademarks. Such usage does not imply official endorsement or partnership with the referenced corporations. All external brand elements remain the intellectual property of their respective proprietors. This project operates autonomously and is not formally affiliated with or sponsored by any mentioned external entity.