ClickUp

You can run and connect to the ClickUp MCP Server to manage ClickUp data through AI-powered workflows. This MCP server exposes tasks, spaces, folders, and lists as resources, lets you create or move items, and supports AI-assisted task descriptions and prioritization, all via a standardized interface that your MCP client can use.

How to use

Use the ClickUp MCP Server with your MCP client to perform common work management actions from your AI applications. You can explore the workspace hierarchy to understand your Spaces, Folders, and Lists, create and organize lists and folders, and manage tasks with descriptions, due dates, priorities, and assignees. When you want AI-assisted results, request AI-generated task descriptions, summaries, or priority analyses to inform your planning. You can also search across spaces by name and resolve items by name or ID to streamline changes in your automation scripts.

How to install

Prerequisites: Node.js and npm must be available on your system.

# Preferred lightweight option: run directly without installation
npx @taazkareem/clickup-mcp-server

Alternatively, install the MCP server globally so you can run it from any terminal session.

npm install -g @taazkareem/clickup-mcp-server

Configuration and security

Set up your API key and team identifier to connect to ClickUp. Create a .env file in your working directory with these values, then reference them when starting the server.

CLICKUP_API_KEY=your_api_key_here
TEAM_ID=your_team_id_here

Using with Cursor AI Composer

To add this server to Cursor AI Composer, configure a MCP Server entry using the runtime command shown here. This starts the server with your ClickUp credentials embedded via environment flags.

npx -y @taazkareem/clickup-mcp-server \
  --env CLICKUP_API_KEY=your_api_key_here \
  --env TEAM_ID=your_team_id_here

Notes and security reminders

Your API key and team identifier are used to authenticate requests to ClickUp. Treat them as secret values and store them securely. When running in shared environments, prefer environment-based configuration and avoid hard-coding keys in scripts.

Available tools

workspace_hierarchy

Lists complete hierarchy of the ClickUp workspace, showing spaces, folders, and lists with IDs, available statuses, and a tree view of your organization.

create_task

Creates a new task in ClickUp with required name and optional details like listId/listName, description, status, priority, dueDate, and assignees.

create_bulk_tasks

Creates multiple tasks in a single operation, with per-task definitions for name, description, status, priority, dueDate, and assignees; can target a specific list.

create_list

Creates a new list within a space with name and optional properties like spaceId/spaceName, content, status, priority, and dueDate.

create_folder

Creates a new folder within a space with a name and optional space identifiers and status override.

create_list_in_folder

Creates a new list inside a specified folder, with optional folder/space context and content/status.

move_task

Moves an existing task to a different list, identified by taskId and destination list (listId or listName).

duplicate_task

Creates a copy of an existing task in a target list, identified by taskId and destination list (listId or listName).

update_task

Updates properties of an existing task, identified by taskId, with optional new name, description, status, priority, and dueDate.

summarize_tasks

Generates a comprehensive summary of tasks grouped by status, highlighting priorities and deadlines and suggesting relationships between tasks.

analyze_priorities

Analyzes priority distribution across tasks, identifies misaligned priorities, and recommends adjustments and sequencing.

generate_description

Creates detailed task descriptions including objectives, success criteria, resources, dependencies, and risks.