You can use this MCP server to control ClickUp tasks and workflows from AI assistants. It exposes essential task management capabilities through natural language, letting you create, update, list, search, and collaborate on tasks, manage time tracking and templates, and gain team analytics without needing to dive into ClickUp’s full feature set.

How to use

Install and run the MCP server, then connect it to your AI assistant client. You can issue natural language requests like creating tasks, listing spaces and lists, assigning users, updating statuses, and adding comments. Use the AI assistant’s MCP integration to trigger the server’s actions, and expect structured responses that reflect ClickUp task data, status changes, or analytics.

How to install

# Quick Start: from source
uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp

# Or from PyPI when published
uvx clickup-mcp

# Development installation
git clone https://github.com/DiversioTeam/clickup-mcp
cd clickup-mcp
uv sync
uv run clickup-mcp

Please ensure you have Python and uvx installed on your system before running the commands.

## Configuration

Set your ClickUp API key to enable the MCP server to access your data. You can configure it in two ways:

## API key setup

Set your ClickUp API key

uvx clickup-mcp set-api-key YOUR_API_KEY_HERE

Or set an environment variable

export CLICKUP_MCP_API_KEY=your_api_key

{
  "env": {
    "CLICKUP_MCP_API_KEY": "YOUR_API_KEY_HERE"
  }
}

"],

## Getting your ClickUp API key

Follow these steps to generate a personal API token in ClickUp and use it with the MCP server. Make sure you copy the token immediately and store it securely.

## Usage with AI assistants

Configure your AI assistant client to connect to this MCP server. The server runs as a local process you start with a simple command, and your assistant can send requests to perform tasks, search, and manage collaborators.

## Example usage patterns

- Create a new task in a specific list and assign a user
- List all tasks with a given status or tag
- Add a comment to a task and log time spent
- Create a chain of dependent tasks for a feature sprint
- Retrieve workload analytics across the team
- Move or bulk-update multiple tasks at once
- Create a task from a predefined template (bug, feature, code review)

## Security considerations

Only expose the MCP server to trusted environments and use secure channels for API communication. Protect your API key and rotate it if you suspect it has been compromised.

## Available tools

### create\_task

Create new tasks with essential fields such as name, description, due date, and priority.

### get\_task

Retrieve task details by ID or other supported ID formats.

### update\_task

Update properties of an existing task, such as status, assignees, or due date.

### delete\_task

Delete tasks by ID.

### create\_task\_from\_template

Create tasks from predefined templates like bug report, feature request, or code review.

### create\_task\_chain

Create a sequence of dependent tasks representing a workflow.

### list\_tasks

List tasks with filtering options such as status, assignee, priority, and text search.

### search\_tasks

Search tasks by text and criteria across your workspace.

### get\_subtasks

Retrieve all subtasks under a parent task.

### get\_task\_comments

Fetch comments associated with a task.

### create\_task\_comment

Add a comment to a task.

### get\_task\_status

Get the current status of a task.

### update\_task\_status

Change the status of a task.

### get\_assignees

List users assigned to a task.

### assign\_task

Assign users to a task.

### list\_spaces

List all spaces in the workspace.

### list\_folders

List folders within a space.

### list\_lists

List all lists.

### find\_list\_by\_name

Find lists by name.

### bulk\_update\_tasks

Update multiple tasks in a single operation.

### bulk\_move\_tasks

Move multiple tasks to different lists.

### get\_time\_tracked

Get time tracked for users or periods.

### log\_time

Log time spent on tasks.

### get\_team\_workload

See task distribution across team members.

### get\_task\_analytics

Get velocity metrics and completion rates.

### list\_users

List all users in the workspace.

### get\_current\_user

Get the currently authenticated user details.

### find\_user\_by\_name

Find users by name or email.