ClickUp

You can run this ClickUp MCP Server Enhanced Fork to bridge ClickUp tasks with AI-driven workflows. It adds task dependency management, improved parameter handling, and extensive tooling while remaining compatible with the original MCP server model. Use this to automate task creation, tracking, tagging, and even complex dependency chains across your ClickUp spaces, all reachable through MCP-compatible clients.

How to use

You interact with the server through an MCP client that connects to the server via a local process or a remote endpoint. Start the server using the recommended command, then send requests to manage tasks, dependencies, tags, time entries, and more. The enhanced dependency tools let you create and inspect task relationships, bulk-create dependencies, and visualize dependency chains. Use the provided tools to query dependencies, add multiple links at once, and prevent circular dependencies. You can enable document management, time tracking, and universal ClickUp API access as needed.

How to install

Prerequisites: Node.js and npm should be installed on your system. You will run the MCP server as a local process via npm/npx.

1. Prepare a configuration that starts the MCP server as a local process.

2. Install and run the server using the command block shown below.

Configuration and run details

Configure your MCP client with the following settings to connect to ClickUp through the MCP server. Provide your ClickUp API key and team ID. You can toggle document support and other options as needed.

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

Security and best practices

Keep your API keys secure. Use environment variables to avoid embedding sensitive values in code or scripts. Restrict access to the MCP endpoint and enable any applicable rate limiting or auth checks provided by your MCP client or gateway.

Troubleshooting

If the server does not start, verify that Node.js and npm are installed, that you have network access to fetch the MCP package, and that the environment variables are set correctly. Check that the ClickUp API key and Team ID are valid for your workspace.

Examples of operations you can perform

Create a dependency: link Task A to depend on Task B.

View dependencies for a project to understand the chain of tasks and their blockers.

Bulk create dependencies to set up multiple relationships in one operation.

Tool overview

The server provides a broad set of tools to manage tasks, spaces, tags, time tracking, and more. See the detailed tool list below for capabilities you can invoke via the MCP connection.

Next steps

Once your MCP client is configured, start issuing commands to create and manage tasks, workers, tags, and documents, while leveraging the dependency management features to maintain coherent project workflows.

Available tools

get_task_dependencies

View task dependency chains to understand which tasks depend on others and in what order.

add_bulk_dependencies

Create multiple dependencies in a single operation to efficiently establish relationships between tasks.

create_task

Create a new task with required fields, supporting single or bulk creation.

update_task

Update task properties, including dates, assignees, and metadata.

delete_task

Delete a task from a workspace.

move_task

Move a task to a different list or folder within the workspace.

duplicate_task

Duplicate a task, including subtasks if needed.

add_comment

Add a comment to a task.

add_attachment

Attach files to a task.

set_start_due_date

Set start and due dates on tasks, with support for natural language input.

create_subtask

Create subtasks under a parent task.

tag_management

Create, update, and delete space tags; add or remove tags from tasks; view all space tags.

time_tracking

Start/stop time tracking, view time entries, and manage billable/non-billable time.

member_management

Manage workspace members, resolve assignees, and view member details and permissions.

document_management

List and manage documents, pages, and updates within the workspace.

custom_api_access

Call any ClickUp endpoint directly, enabling advanced integrations.