This implementation serves as a Model Context Protocol (MCP) backend, specifically engineered to bridge AI agents with the full capabilities of the ClickUp API. It abstracts complex API calls into straightforward, conversational commands for managing tasks, spaces, organizational containers (folders/lists), and associated metadata.

🚧 Status Update: Version 0.6.9 is imminent, introducing advanced features such as universally accessible task lookups with intelligent ambiguity resolution, native processing of natural language expressions for task start dates, full support for task labeling including color manipulation via plain language, management of hierarchical subtasks, integration of custom identifiers, and refinements to internal logging mechanisms.

Deployment Prerequisites

Acquire necessary authentication secrets:
Your unique ClickUp API authorization token found under ClickUp App Configuration
The designated Team Identifier obtained from your ClickUp portal's URL structure.
Select deployment strategy: Utilize the hosted subscription service (which relies on webhooks) or the direct NPX installation (which fetches dependencies locally).
Begin leveraging natural language syntax to orchestrate your work environment!

Smithery Quick Deployment

This component is accessible via the Smithery service repository. From that interface, you can inspect available functions or generate the precise execution command tailored for your consuming application.

Local NPX Installation Guide

Incorporate the following configuration snippet into your client application's MCP configuration file:

{ "mcpServers": { "ClickUp": { "command": "npx", "args": [ "-y", "@taazkareem/clickup-mcp-server@latest" ], "env": { "CLICKUP_API_KEY": "your-api-key", "CLICKUP_TEAM_ID": "your-team-id" } } } }

Alternatively, execute the following direct shell command:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Core Functionality Matrix

Task Orchestration	Metadata Tagging	Label Management
• Initiate, revise, and retire items • Facilitate task relocation and cloning across structures • Support for singular and batch operations • Scheduling via colloquial date inputs • Generation and handling of subordinate items • Comment insertion and file association
• Define, modify, and erase metadata tags at the space level • Apply or detach existing tags from tasks • Interpret natural language instructions for tag coloration • Automatic contrast-safe foreground color derivation • Retrieval of all defined space tags • Cross-workspace organization leveraging tags
Time Tracking Utility	Hierarchical Navigation	API Interoperability
• Audit time logs associated with tasks • Toggle active time logging on specific items • Inject manually recorded time segments • Purge recorded time entries • Report on currently active timer status • Differentiate between billable and non-billable effort
• Traverse spaces, folders, and task lists • Provision new folder containers • Structure lists underneath existing spaces • Instantiate new lists within defined folders • Visualize the complete organizational map • Streamlined path-based lookups
• Global lookup capability (by textual name or unique identifier) • Case-insensitive matching logic • Rendering support for Markdown syntax • Integrated mechanism for request throttling control • Robust error detection and recovery protocols • Broad coverage of the underlying API surface

Exposed Operations

Operation	Reference Link	Mandatory Inputs	Specificity
get_workspace_hierarchy	docs/api-reference.md#workspace-navigation	None	Retrieves the entire structural blueprint.
create_task	docs/api-reference.md#task-management	`name`, (`listId`/`listName`)	Item instantiation.
create_bulk_tasks	docs/api-reference.md#task-management	`tasks[]`	Batch item creation.
update_task	docs/api-reference.md#task-management	`taskId`/`taskName`	Modify attributes of an existing item.
update_bulk_tasks	docs/api-reference.md#task-management	`tasks[]` with IDs or names	Bulk modification sequence.
get_tasks	docs/api-reference.md#task-management	`listId`/`listName`	Fetch items within a designated list.
get_task	docs/api-reference.md#task-management	`taskId`/`taskName`	Retrieve singular item details (utilizes smart matching).
get_workspace_tasks	docs/api-reference.md#task-management	At least one filter (tags, list_ids, space_ids, etc.)	Broad retrieval subject to filtering criteria.
get_task_comments	docs/api-reference.md#task-management	`taskId`/`taskName`	Access discussion threads attached to an item.
create_task_comment	docs/api-reference.md#task-management	`commentText`, (`taskId`/(`taskName`+`listName`))	Append dialogue to an item.
attach_task_file	docs/api-reference.md#task-management	`taskId`/`taskName`, (`file_data` or `file_url`)	Associate digital assets.
delete_task	docs/api-reference.md#task-management	`taskId`/`taskName`	Permanent removal of an item.
delete_bulk_tasks	docs/api-reference.md#task-management	`tasks[]` with IDs or names	Batch item archival/removal.
move_task	docs/api-reference.md#task-management	`taskId`/`taskName`, `listId`/`listName`	Relocate task structure.
move_bulk_tasks	docs/api-reference.md#task-management	`tasks[]` with IDs or names, target list	Batch structural relocation.
duplicate_task	docs/api-reference.md#task-management	`taskId`/`taskName`, `listId`/`listName`	Create an exact copy.
create_list	docs/api-reference.md#list-management	`name`, `spaceId`/`spaceName`	Instantiate a new list within a defined space.
create_folder	docs/api-reference.md#folder-management	`name`, `spaceId`/`spaceName`	Provision a new organizational folder.
create_list_in_folder	docs/api-reference.md#list-management	`name`, `folderId`/`folderName`	Instantiate a new list inside a folder.
get_folder	docs/api-reference.md#folder-management	`folderId`/`folderName`	Retrieve specific folder metadata.
update_folder	docs/api-reference.md#folder-management	`folderId`/`folderName`	Modify folder attributes.
delete_folder	docs/api-reference.md#folder-management	`folderId`/`folderName`	Decommission a folder structure.
get_list	docs/api-reference.md#list-management	`listId`/`listName`	Retrieve specific list details.
update_list	docs/api-reference.md#list-management	`listId`/`listName`	Modify list attributes.
delete_list	docs/api-reference.md#list-management	`listId`/`listName`	Decommission a list.
get_space_tags	docs/api-reference.md#tag-management	`spaceId`/`spaceName`	View tags scoped to a space.
create_space_tag	docs/api-reference.md#tag-management	`tagName`, `spaceId`/`spaceName`	Define a new organizational tag.
update_space_tag	docs/api-reference.md#tag-management	`tagName`, `spaceId`/`spaceName`	Modify an existing tag's definition.
delete_space_tag	docs/api-reference.md#tag-management	`tagName`, `spaceId`/`spaceName`	Erase a space-level tag.
add_tag_to_task	docs/api-reference.md#tag-management	`tagName`, `taskId`/(`taskName`+`listName`)	Associate a tag label with a task.
remove_tag_from_task	docs/api-reference.md#tag-management	`tagName`, `taskId`/(`taskName`+`listName`)	Detach a tag label from a task.
get_task_time_entries	docs/api-reference.md#time-tracking	`taskId`/`taskName`	Audit time logs for an item.
start_time_tracking	docs/api-reference.md#time-tracking	`taskId`/`taskName`	Initiate stopwatch function for an item.
stop_time_tracking	docs/api-reference.md#time-tracking	None	Halt the currently active timer session.
add_time_entry	docs/api-reference.md#time-tracking	`taskId`/`taskName`, `start`, `duration`	Record time retrospectively.
delete_time_entry	docs/api-reference.md#time-tracking	`timeEntryId`	Erase a specific time record.
get_current_time_entry	docs/api-reference.md#time-tracking	None	Check status of active time measurement.

Consult Comprehensive Documentation for optional parameters and advanced utilization patterns.

AI Prompting Capabilities (Under Development)

This section is currently unimplemented across all client interfaces. Users are encouraged to propose specific AI Prompt integrations that would significantly enhance their operational workflows (avoiding overly narrow requests).

Prompt Operation	Intended Function	Supported Outputs
summarize_tasks	Consolidated task status overview	Status aggregation, priority mapping, dependency visualization
analyze_priorities	Optimization assessment for item sequencing	Distribution analysis across urgency levels, suggested execution order
generate_description	Automated artifact creation for new work items	Definition of scope, acceptance criteria generation, dependency outlining

Exception Handling Protocols

The gateway furnishes descriptive diagnostics for various failure conditions, including: - Incomplete required arguments. - Utilization of non-existent identifiers or names. - Failure to locate specified resources. - Authorization or access restrictions. - Failures originating from the remote API service. - Rate limit breaches.

The verbosity of the service's operational logs is governed by the LOG_LEVEL environment variable, which accepts values: trace, debug, info, warn, and error (the default setting). This can also be adjusted upon invoking the command line, like so: --env LOG_LEVEL=info.

Developer Endorsement

While utilizing this server component, you may occasionally encounter a subtle promotional message containing a repository link embedded within tool outputs. Support for this project is greatly appreciated! If you find this integration valuable, kindly consider contributing via these channels:

Credits and Affiliations

Our sincere gratitude extends to ClickUp for furnishing the powerful Application Programming Interface which underpins this functionality.

Collaborative Opportunities

New contributions are highly encouraged! Consult our Contributor Guidelines for detailed instructions.

Legal Notice

This system is released under the terms of the MIT License; review the LICENSE file for specifics.

This application interfaces with and references third-party Application Programming Interfaces and may mention trademarks or brand identifiers belonging to other entities. Such usage does not imply official partnership or sponsorship from the referenced corporations. All proprietary trademarks remain the property of their respective holders. This project is an independent creation, devoid of official association or funding from any mentioned third party. WIKIPEDIA INSIGHT: Organizational management utilities encompass the entire spectrum of systems, software, governance mechanisms, computational frameworks, and operational philosophies deployed by enterprises to adapt to fluctuating commercial environments, secure competitive standing, and enhance overall operational efficacy.

== Conceptual Framework == Management utilities are often segmented according to departmental focus and specific functional aspects, such as resource allocation, operational workflow control, archival and record-keeping, personnel administration, strategic decision modeling, performance monitoring, and so forth. A functional categorization typically addresses these universal management domains:

Frameworks for data ingestion and input verification across all organizational sectors. Systems designed for auditing and refinement of core operational sequences. Platforms used for synthesizing aggregated data to facilitate executive judgment. Modern management apparatus has undergone profound transformation recently, driven by rapid technological evolution, making the selection of optimal business instruments for diverse organizational needs increasingly complex. This challenge stems from the continuous pressure to reduce expenditures while maximizing revenue, the imperative to deeply understand client requirements, and the necessity of product delivery conforming precisely to customer expectations. Within this dynamic setting, executive leadership must adopt a strategic stance regarding enterprise management tools rather than defaulting to the newest available option. Managers frequently implement tools without necessary customization, leading to systemic instability. Consequently, business management solutions must be chosen deliberately and subsequently tailored to fit the organization's specific demands, rather than forcing the organization to conform to the tool's inherent structure.

== Prominent Instruments (2013 Survey) == In a 2013 assessment by Bain & Company, global utilization patterns of business tools were mapped, reflecting how their resultant outputs address regional necessities, accounting for prevailing economic trends. The ten leading categories included:

Strategic roadmap formulation Customer loyalty management systems Personnel sentiment evaluation programs Comparative performance analysis (Benchmarking) Integrated performance measurement framework (Balanced Scorecard) Identification of core organizational strengths Offshoring and external sourcing strategies Organizational transformation initiatives Logistics and distribution network oversight Definition of core organizational purpose and future direction Client base segmentation analysis Comprehensive quality assurance methodologies

== Enterprise Software Applications == Computing programs or suites utilized by personnel to execute diverse corporate functions are termed business software or applications. These digital instruments enhance productivity, quantify performance metrics, and ensure precision across various company procedures. The evolution traces from early Management Information Systems (MIS) to integrated Enterprise Resource Planning (ERP), later incorporating Customer Relationship Management (CRM) modules, culminating in the current landscape dominated by cloud-based enterprise management suites. While a demonstrable link exists between IT investments and organizational success, two factors are critical multipliers: the proficiency of the implementation process and the judicious selection and subsequent adaptation of the chosen instruments.

== Tools for Small and Medium Enterprises (SMEs) == Tools specifically tailored for SMEs are vital as they offer avenues for cost containment and efficient resource utilization...