clickup-integration-gateway

This Model Context Protocol (MCP) endpoint furnishes a robust bridge for linking external intelligent systems with the ClickUp platform. It facilitates declarative interaction with core ClickUp entities—tasks, organizational containers, time tracking data, and file references—through a universally defined communication schema.

🚀 Latest Release Notes: Version 0.7.2 introduces comprehensive modules for tracking time expenditure and advanced document handling capabilities.

Deployment Prerequisites

1. Secure Authentication Tokens:
2. Obtain your personal ClickUp Personal API Token via ClickUp Developer Settings
3. Identify your primary Workspace Identifier (Team ID) from the application URL.
4. Installation Methodology Selection:
5. Opt for the Webhook-enabled Hosted deployment path for real-time updates, or use NPX for direct local asset provisioning.
6. Initiate Orchestration:
7. Leverage descriptive, natural language directives to govern your workspace state.

Quick Integration via Smithery

The service is externally accessible through the Smithery registry. Access the registry to explore the functional toolset or retrieve exact execution strings tailored for your consuming application.

Standard NPX Provisioning

Incorporate the subsequent configuration block into your client's designated MCP configuration manifest:

{ "mcpServers": { "ClickUp": { "command": "npx", "args": [ "-y", "@taazkareem/clickup-mcp-server@latest" ], "env": { "CLICKUP_API_KEY": "your-secret-key", "CLICKUP_TEAM_ID": "your-workspace-identifier", "DOCUMENT_SUPPORT": "true" } } } }

Alternatively, utilize this direct shell invocation:

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

Note: Omitting the explicit setting of "DOCUMENT_SUPPORT": "true" results in document interaction features remaining deactivated by default.

Furthermore, the DISABLED_TOOLS environment variable, or the equivalent --env DISABLED_TOOLS command-line argument, permits feature pruning. Supply a comma-delimited list of tool identifiers to exclude (e.g., create_task,delete_task).

It is recommended to disable functionalities you are not utilizing to mitigate potential constraints related to tool count or context window limitations.

Core Capabilities Matrix

Task Administration	Tag Registry Management
• Creation, modification, and removal of individual tasks • Relocation and duplication across the hierarchy • Atomic and batch processing support • Natural language scheduling (start/due dates) • Subtask lifecycle management • Commenting and file attachment integration	• CRUD operations for space-level metadata tags • Association and disassociation of tags with tasks • Semantic color specification for tags • Automated generation of contrasting text hues • Enumeration of all available space tags • Task grouping via tags throughout the environment
⏱️ Temporal Logging	🌳 Structural Mapping
• Retrieval of time records associated with a task • Initiation/cessation of active tracking on items • Injection of retroactive time entries • Time entry deletion mechanism • Querying the currently active timer status • Recording of billable vs. non-billable duration	• Traversal of spaces, folders, and lists structure • Provisioning new folder entities • Organizing lists within container folders • List instantiation within folders • Visualization of the entire workspace topology • Optimized positional referencing
📄 Document Content Handling	⚡ Interoperability Enhancements
• Comprehensive indexing of all workspace documentation • Listing of pages within a document • Retrieval of specific page metadata • Initialization of new document assets • Content modification (insertion at start/end)	• Lookup flexibility via name or system identifier • Case-insensitive string matching algorithms • Native support for Markdown rendering • Integrated request throttling mechanisms • Robust error trapping and data validation • Extensive underlying API mapping

Consult the comprehensive API documentation for complete details on optional parameters and advanced operational modes.

Operational Toolset Inventory

Tool Identifier	Purpose Description	Mandated Input Arguments
get_workspace_hierarchy	Map the organizational blueprint	None
create_task	Provision a new to-do item	name, (listId/listName)
create_bulk_tasks	Provision numerous to-do items	tasks[] array
update_task	Modify existing task attributes	taskId/taskName
update_bulk_tasks	Modify multiple task records	tasks[] collection identified by IDs or names
get_tasks	Fetch items within a specified list	listId/listName
get_task	Retrieve granular details for one item	taskId/taskName (supports intelligent entity resolution)
get_workspace_tasks	Fetch tasks applying specified criteria	A minimum of one filtering predicate (tags, list IDs, space IDs, etc.)
get_task_comments	Retrieve chronological feedback on a task	taskId/taskName
create_task_comment	Append commentary to an item	commentText, (taskId/(taskName+listName))
attach_task_file	Affix external data to a task	taskId/taskName, (file_data or file_url)
delete_task	Erase a task record	taskId/taskName
delete_bulk_tasks	Purge multiple task records	tasks[] collection identified by IDs or names
move_task	Reassign task location	taskId/taskName, listId/listName
move_bulk_tasks	Reassign multiple tasks	tasks[] collection identified by IDs or names, destination list identifier
duplicate_task	Generate an identical copy	taskId/taskName, listId/listName
create_list	Institute a new list within a space	name, spaceId/spaceName
create_folder	Establish a new folder grouping	name, spaceId/spaceName
create_list_in_folder	Institute a new list within a folder	name, folderId/folderName
get_folder	Retrieve folder metadata	folderId/folderName
update_folder	Revise folder attributes	folderId/folderName
delete_folder	Retire a folder entity	folderId/folderName
get_list	Retrieve list metadata	listId/listName
update_list	Revise list attributes	listId/listName
delete_list	Retire a list entity	listId/listName
get_space_tags	Enumerate tags for a space	spaceId/spaceName
create_space_tag	Define a new metadata tag	tagName, spaceId/spaceName
update_space_tag	Revise an existing tag's definition	tagName, spaceId/spaceName
delete_space_tag	Eliminate a metadata tag	tagName, spaceId/spaceName
add_tag_to_task	Assign a tag to an item	tagName, taskId/(taskName+listName)
remove_tag_from_task	Unassign a tag from an item	tagName, taskId/(taskName+listName)
get_task_time_entries	Fetch time logs for a task	taskId/taskName
start_time_tracking	Initiate active time measurement	taskId/taskName
stop_time_tracking	Terminate active time measurement	None
add_time_entry	Log time retrospectively	taskId/taskName, start, duration
delete_time_entry	Erase a logged time record	timeEntryId
get_current_time_entry	Determine currently active timer	None
create_document	Generate a new documentation asset	workspaceId, name, parentId/parentType, visibility, create_pages
get_document	Retrieve a specific document	workspaceId/documentId
list_documents	Index all stored documents	workspaceId, documentId/creator/deleted/archived/parent_id/parent_type/limit/next_cursor
list_document_pages	Index pages within a document	documentId/documentName
get_document_pages	Fetch content of specified pages	documentId/documentName, pageIds
create_document_pages	Instantiate a new documentation page	workspaceId/documentId, parent_page_id/name/sub_title,content/content_format
update_document_page	Modify content of a documentation page	workspaceId/documentId, name/sub_title,content/content_edit_mode/content_format

Review the API Reference for comprehensive parameter specifications.

Specialized AI Directives (Prompts)

This capability set is currently under development and might not be universally supported by all client frontends. Kindly submit feature requests for directives that would significantly benefit your operational throughput (avoiding excessive specificity).

Directive Name	Core Function	Key Attributes
summarize_tasks	Task Portfolio Abstraction	Status aggregates, priority mapping, inter-item dependencies
analyze_priorities	Priority Load Optimization	Distribution heatmaps, optimized sequential ordering
generate_description	Automated Task Elaboration	Objective definition, success criteria, prerequisite linkage

Operational Feedback Mechanisms

The server furnishes unambiguous diagnostic messages concerning the following failure modes:

• Omission of essential configuration parameters
• Use of non-existent identifiers or names
• Failure to locate specified resources
• Access constraint violations
• Errors relayed from the upstream ClickUp API
• Traffic throttling indications

The verbosity of runtime logging is governed by the LOG_LEVEL environment variable. Permissible settings include trace, debug, info, warn, and error (the default setting). This can also be controlled via command-line flags, such as --env LOG_LEVEL=info.

Developer Support Encouragement

Use of this integration module may occasionally result in the inclusion of a brief sponsorship solicitation, including a hyperlink to this source repository, within tool outputs. Your consideration in supporting the project is greatly appreciated! If this software proves valuable to your workflow, please contemplate sponsorship:

Attribution

Profuse thanks to ClickUp for providing the robust API infrastructure necessary for this connectivity solution.

Collaboration Guidelines

We welcome contributions! Review the Contribution Instructions for detailed submission standards.

Legal Framework

This software operates under the terms of the MIT License; refer to the LICENSE file for full legal disclosure.

Disclosure Statement

This utility utilizes external third-party APIs and may reference branding or trademarks belonging to other entities. Such utilization does not constitute endorsement or formal partnership with the referenced corporations. All intellectual property, including brand names and trademarks, remains the property of their respective holders. This repository represents an independent development effort, unassociated with or sponsored by any mentioned external organization.

WIKIPEDIA CONTEXT: Enterprise administration utilities encompass the entire spectrum of systems, applications, supervisory controls, computational frameworks, and operational methodologies employed by commercial entities to navigate shifting market dynamics, secure competitive positioning, and enhance overall organizational efficacy.

== Abstract: Management Tool Taxonomy == Associated tools exist for specialized organizational functions, classifiable across various management dimensions: e.g., predictive planning instruments, workflow enforcement mechanisms, data archival utilities, personnel management platforms, strategic decision support systems, performance oversight apparatus, and so forth. A functional categorization typically encompasses:

• Data acquisition and conformity verification instruments applicable across all divisions.
• Systems dedicated to process governance and operational refinement.
• Frameworks for data aggregation and informed executive decision-making. Modern management apparatus has undergone profound transformation over the last decade due to accelerated technological progress, frequently making the selection of optimal business tools for a given scenario exceedingly complex. This complexity stems from the ceaseless drive for cost reduction coupled with sales maximization, the imperative to deeply understand clientele requirements, and the pressure to deliver products meeting those precise demands. Within this environment, executive leadership must adopt a forward-looking posture toward business utility selection, rather than defaulting to the newest available option. In many instances, management adopts tools without necessary organizational tailoring, leading to structural instability. Consequently, business management tools must undergo meticulous selection and subsequent customization to align with inherent organizational requirements, reversing the conventional dependency.

== Prevalent Instruments == Data published in 2013 by Bain & Company detailed the global deployment patterns of business tools, reflecting regional necessities influenced by economic downturns and market conditions. The top ten instrumentation categories identified were:

Strategic planning Customer relationship management Employee engagement surveys Benchmarking Balanced scorecard Core competency identification Outsourcing strategies Change management programs Supply chain management Mission statement and vision statement formulation Market segmentation analysis Total quality management methodologies

== Business Software Applications == Computing programs or collections of software utilized by personnel to execute diverse commercial functions are termed business software (or business applications). These applications serve to elevate productivity metrics, quantify organizational output, and perform various corporate tasks with precision. The evolution progressed from rudimentary Management Information Systems (MIS) to comprehensive Enterprise Resource Planning (ERP) suites, subsequently integrating Customer Relationship Management (CRM) functionalities, culminating in the contemporary cloud-based enterprise management space. While a tangible correlation exists between IT investment efficacy and organizational performance, two factors are paramount for value realization: the effectiveness of the deployment process and the judicious selection and subsequent adaptation of the supporting toolset.

== Provisions for Small and Medium Enterprises (SMEs) == Tools specifically engineered for SMEs are crucial as they furnish avenues for resource conservation a...