Clickup MCP Server

The ClickUp MCP Server is a model context protocol server for integrating ClickUp tasks with AI applications, supporting task, space, list, and folder management through a standardized protocol.

Developer tools Schedule management #Task Management #AI Integration #Time Tracking #Workspace Organization Local .TypeScript

rating : 3 points

downloads : 120

update time : 2025-04-29

What is the ClickUp MCP Server?

The ClickUp MCP Server is a tool that supports the Model Context Protocol (MCP). It allows AI systems to seamlessly access your ClickUp tasks, spaces, lists, and folders. You can use natural language to manage tasks and organize workflows.

How to use the ClickUp MCP Server?

You just need to provide the API key and team ID, and then quickly set it up through the command line or the integrated client. You can start using it without complex configuration.

Applicable Scenarios

Suitable for individuals or teams that need to efficiently manage tasks, organize projects, and improve productivity, especially those users who want to integrate AI technology into their daily work.

Main Features

Task ManagementCreate, update, and delete tasks; support batch operations; set start and due dates; add subtasks and comments.

Tag ManagementCreate, modify, and delete space tags; assign tags to tasks; automatically adjust contrast colors.

Time TrackingView task time records; start and stop timers; manually add time entries.

Workspace OrganizationNavigate spaces, folders, and lists; create and manage folders; optimize task paths.

Integration FeaturesSupport global search; intelligent fuzzy matching; built - in error handling and rate limiting.

Advantages and Limitations

Advantages

Powerful task management and automation capabilities

Support for multilingual natural interaction

Real - time time tracking and billing support

Limitations

Requires a valid ClickUp account

Some advanced features may depend on ClickUp API permissions

How to Use

Get the ClickUp API Key

Go to the ClickUp settings page to generate an API key.

Get the Team ID

Find the team ID in the ClickUp workspace URL.

Install the ClickUp MCP Server

Use the NPX command to quickly install or preview the function through the Smithery platform.

Usage Examples

Create a New TaskAdd a new task to ClickUp.

Time TrackingStart time tracking for a specific task.

Frequently Asked Questions

How to get the ClickUp API key?

Does it support batch task operations?

Does the time - tracking function support manual input?

Related Resources

ClickUp MCP Server Documentation

Comprehensively understand the server's functions and API interfaces.

GitHub Code Repository

View the source code and contribute.

Buy the Author a Coffee to Support

Support the developer to continue maintaining this project.

🚀 Project Documentation

This project offers a comprehensive task management system with features like task management, tag management, and time tracking.

🚀 Quick Start

The project provides a set of APIs for task management, tag management, and time tracking. You can use these APIs to create, update, and delete tasks, tags, and time entries.

✨ Features

Feature Overview

Task Management: Includes operations such as creating, updating, and deleting tasks, as well as adding tags and descriptions.
Tag Management: Supports creating, updating, and deleting space tags, and associating or disassociating tags with tasks.
Time Tracking: Provides functions to start, stop, add, and delete task time records.

Detailed Feature List

Images

Buy Me A Coffee

Functional Modules

Task Management

Function Name	Purpose	Features
summarize_tasks	Task overview	Status summary, priority, relationship analysis
analyze_priorities	Priority optimization	Distribution analysis, sorting function
generate_description	Description generation	Goal setting, standard formulation, dependency identification

Tag Management

Function Name	Parameters	Function Description
get_space_tags	spaceId or spaceName	Get all tags in the specified space
create_space_tag	tagName, spaceId or spaceName	Create a new tag
update_space_tag	tagName, spaceId or spaceName	Update the information of an existing tag
delete_space_tag	tagName, spaceId or spaceName	Delete the specified tag

Time Tracking

Function Name	Parameters	Function Description
get_task_time_entries	taskId or taskName	Get the time records of a task
start_time_tracking	taskId or taskName	Start time tracking for a task
stop_time_tracking	No parameters	Stop the currently running time record
add_time_entry	taskId or taskName, startTime, duration	Add a manual time record
delete_time_entry	timeEntryId	Delete the specified time record
get_current_time_entry	No parameters	Get the currently running time record

Error Handling

The server provides clear error messages, including:

Missing required parameters
Invalid ID or name
Resource not found
Permission issues
API errors
Request frequency limits

The LOG_LEVEL environment variable can be set to trace, debug, info, warn, error (default) to control the detail level of server logs. This variable can also be specified via the command line, for example: --env LOG_LEVEL=info.