clickup-mcp-server: A ClickUp MCP Server

Name: clickup-mcp-server: A ClickUp MCP Server
Author: imjoshnewton

@imjoshnewton

Repository

About clickup-mcp-server: A ClickUp MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "clickup-mcp-server-imjoshnewton": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp/clickup",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is clickup-mcp-server?

A Model Context Protocol server for ClickUp API interaction and automation, enabling AI systems like Claude to read, create, and update tasks, lists, and spaces in ClickUp workspaces.

How to use clickup-mcp-server?

Install via pip install clickup-mcp-server or run directly with uvx clickup-mcp-server. Provide your ClickUp API key as a command-line argument (--api-key) or in a .env file (CLICKUP_API_KEY). Configure the server in Claude Desktop, VS Code, or Zed using the provided JSON snippets.

Key features of clickup-mcp-server

Create, update, delete, move, and duplicate tasks
Bulk update and bulk delete tasks
Manage subtasks, comments, and attachments
Navigate and manage workspaces, spaces, folders, and lists
Full markdown support with HTML conversion for descriptions
Comprehensive error handling and clear API responses

Use cases of clickup-mcp-server

Automate task creation and status updates across multiple lists
Bulk assign, tag, or update due dates for project milestones
Navigate and reorganize workspace hierarchy (spaces, folders, lists)
Generate project summaries with task details and comments
Integrate AI assistants into ClickUp workflows for project management

FAQ from clickup-mcp-server

What are the prerequisites?

Python 3.10 or higher and a ClickUp account with an API key.

How do I get a ClickUp API key?

Obtain it from the ClickUp API Settings page at https://app.clickup.com/settings/apps.

How do I run clickup-mcp-server?

Use uvx clickup-mcp-server --api-key YOUR_API_KEY or after pip installation, run python -m clickup_mcp_server --api-key YOUR_API_KEY.

Can I use it with Claude Desktop?

Yes, add a configuration entry to claude_desktop_config.json using uvx, docker, or the pip-installed module as shown in the README.

Does it support bulk operations?

Yes, it provides bulk_update_tasks and bulk_delete_tasks tools for updating or deleting multiple tasks at once.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K