ClickUp MCP server for AI agents

The ClickUp MCP server enables seamless integration between ClickUp tasks and AI applications through the Model Context Protocol (MCP). This server allows AI agents to interact with your ClickUp workspace using natural language commands for task management, document handling, and workspace organization.

Installation Options

Smithery Installation (Hosted)

The quickest way to get started is using the hosted version on Smithery:

Visit Smithery Server

On Smithery, you can preview available tools and copy commands to run with your specific client app.

NPX Installation (Local)

Add this configuration to your client's MCP settings JSON file:

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

Alternatively, run this command in your terminal:

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

Note: Set DOCUMENT_SUPPORT to true to enable document management features.

Configuration Options

Tool Filtering

Control which tools are available using environment variables:

Using ENABLED_TOOLS (Recommended)

npx -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY=your-api-key \
  --env CLICKUP_TEAM_ID=your-team-id \
  --env ENABLED_TOOLS=create_task,get_task,update_task,get_workspace_hierarchy

Using DISABLED_TOOLS (Legacy)

npx -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY=your-api-key \
  --env CLICKUP_TEAM_ID=your-team-id \
  --env DISABLED_TOOLS=delete_task,delete_bulk_tasks

HTTP Transport Support

The server supports both modern HTTP Streamable transport and legacy SSE transport:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "ENABLE_SSE": "true",
        "PORT": "3231"
      }
    }
  }
}

Available endpoints:

Primary: http://127.0.0.1:3231/mcp (Streamable HTTP)
Legacy: http://127.0.0.1:3231/sse (SSE)

Command line usage:

npx -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY=your-api-key \
  --env CLICKUP_TEAM_ID=your-team-id \
  --env ENABLE_SSE=true \
  --env PORT=3231

Key Features

Task Management

Create, update, and manage tasks with natural language:

{
  "name": "Prepare quarterly report",
  "description": "Analyze Q3 data and prepare summary for leadership",
  "listName": "Marketing Projects",
  "due_date": "next Friday at 5pm",
  "priority": "high"
}

Tag Management

Create and manage tags across your workspace:

{
  "tagName": "urgent",
  "spaceName": "Marketing",
  "foreground": "white",
  "background": "red"
}

Workspace Navigation

View your entire workspace structure:

{
  // No parameters needed
}

Time Tracking

Track time spent on tasks:

{
  "taskName": "Website redesign",
  "listName": "Development"
}

Document Management

Create and manage documents (requires DOCUMENT_SUPPORT=true):

{
  "workspaceId": "123456",
  "name": "Project Documentation",
  "parentType": "space",
  "parentId": "789012",
  "content": "# Project Overview\n\nThis document outlines..."
}

Available Tools

The server provides 36 tools across various categories:

Workspace Management

get_workspace_hierarchy
get_workspace_members
find_member_by_name
resolve_assignees

Task Management

create_task
update_task
get_task
get_tasks
get_workspace_tasks
delete_task
move_task
duplicate_task
create_task_comment
get_task_comments
attach_task_file
add_tag_to_task
remove_tag_from_task

Bulk Operations

create_bulk_tasks
update_bulk_tasks
delete_bulk_tasks
move_bulk_tasks

List & Folder Management

create_list
get_list
update_list
delete_list
create_folder
get_folder
update_folder
delete_folder
create_list_in_folder

Tag Management

get_space_tags
create_space_tag
update_space_tag
delete_space_tag

Time Tracking

get_task_time_entries
start_time_tracking
stop_time_tracking
add_time_entry
delete_time_entry
get_current_time_entry

Document Management

create_document
get_document
list_documents
list_document_pages
get_document_pages
create_document_pages
update_document_page

Error Handling

The server provides clear error messages for common issues. You can control log verbosity with the LOG_LEVEL environment variable:

npx -y @taazkareem/clickup-mcp-server@latest --env LOG_LEVEL=info

Valid levels are trace, debug, info, warn, and error (default).

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" '{"command":"npx","args":["-y","@taazkareem/clickup-mcp-server@latest"],"env":{"CLICKUP_API_KEY":"your-api-key","CLICKUP_TEAM_ID":"your-team-id","DOCUMENT_SUPPORT":"true"}}'

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": {
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server@latest"
            ],
            "env": {
                "CLICKUP_API_KEY": "your-api-key",
                "CLICKUP_TEAM_ID": "your-team-id",
                "DOCUMENT_SUPPORT": "true"
            }
        }
    }
}

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": {
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server@latest"
            ],
            "env": {
                "CLICKUP_API_KEY": "your-api-key",
                "CLICKUP_TEAM_ID": "your-team-id",
                "DOCUMENT_SUPPORT": "true"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect