ClickUp MCP server for AI agents

The ClickUp MCP Server enables AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol. It serves as a bridge between AI applications and your ClickUp workspace, allowing for automated task management and workspace organization.

Quick Start

Installation with Cursor Composer Agent

Get your credentials:
- ClickUp API key from ClickUp Settings
- Team ID from your ClickUp workspace URL
Go to Features in settings (or MCP Servers depending on version)
Add under MCP Servers:

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

Replace the credentials and click Save
Use Natural Language to interact with your ClickUp Workspace!

Installation via Smithery

The server is also hosted on Smithery, where you can preview available tools or copy commands for specific client applications.

Features

🎯 Task Management
- Create, update, and delete individual tasks
- Move and duplicate tasks between lists, spaces, and folders
- Manage multiple tasks in bulk
- Set due dates using natural language and relative time expressions
📂 Workspace Organization
- Access complete workspace hierarchy (spaces, folders, lists)
- Navigate through tree structure with clear relationships
- Perform full CRUD operations for workspace components
🔄 Integration Features
- Find items by name or ID
- Use case-insensitive name matching
- Support for Markdown formatting
- Built-in API rate limiting protection

Available Tools

Workspace Navigation

get_workspace_hierarchy - Get the complete structure of your workspace

Task Management

create_task - Create a single task with a name and list location
create_bulk_tasks - Create multiple tasks at once
update_task - Modify an existing task's properties
update_bulk_tasks - Modify multiple tasks simultaneously
delete_task - Remove a specific task
delete_bulk_tasks - Remove multiple tasks at once
move_task - Relocate a task to a different list
move_bulk_tasks - Relocate multiple tasks to a new list
duplicate_task - Create a copy of an existing task

Task Retrieval

get_tasks - Retrieve all tasks from a specific list
get_task - Get detailed information about a single task

List Management

create_list - Create a new list in a space
create_list_in_folder - Create a new list inside a folder
get_list - Retrieve details about a specific list
update_list - Modify a list's properties
delete_list - Remove a list

Folder Management

create_folder - Create a new folder in a space
get_folder - Retrieve details about a specific folder
update_folder - Modify a folder's properties
delete_folder - Remove a folder

Usage Examples

Creating a Task

// Create a simple task in a list
{
  "name": "Complete project proposal",
  "listName": "Marketing Projects"
}

Creating Multiple Tasks

// Create several tasks at once
{
  "tasks": [
    {
      "name": "Research competitors",
      "listName": "Market Research",
      "description": "Analyze top 5 competitors in our space"
    },
    {
      "name": "Draft social media plan",
      "listName": "Marketing Projects",
      "due_date": "tomorrow at 5pm"
    }
  ]
}

Updating a Task

// Update task properties
{
  "taskName": "Complete project proposal",
  "description": "Create detailed project plan with timeline and resources",
  "priority": "high",
  "due_date": "next Friday at noon"
}

Moving Tasks Between Lists

// Move a task to a different list
{
  "taskName": "Design homepage mockup",
  "listName": "In Progress" 
}

Creating Workspace Structure

// Create a new folder and lists within it
{
  "name": "Q2 Projects",
  "spaceName": "Marketing"
}

// Then create lists in that folder
{
  "name": "Social Media Campaigns",
  "folderName": "Q2 Projects"
}

Error Handling

The server provides clear error messages for common issues:

Missing required parameters
Invalid IDs or names
Items not found
Permission issues
API rate limiting

When errors occur, check the parameters you're providing and ensure you have the correct permissions in your ClickUp workspace.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "clickup-mcp-server" '{"command":"npx","args":["-y","@taazkareem/clickup-mcp-server@latest"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "clickup-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server@latest"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "clickup-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server@latest"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect