ClickUp MCP Server

Name: ClickUp MCP Server
Author: Nazruden

@Nazruden

About ClickUp MCP Server

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.

Basic information

Config

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

{
  "mcpServers": {
    "clickup-mcp-server-nazruden": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Nazruden/clickup-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

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 (MCP) server that integrates AI assistants with ClickUp workspaces. It enables AI assistants to interact with ClickUp tasks, docs, spaces, folders, views, and custom fields using ClickUp’s API v2/v3. It is intended for developers and users who want to control ClickUp through natural language via an MCP client.

How to use ClickUp MCP Server?

Set the CLICKUP_PERSONAL_TOKEN environment variable with your ClickUp Personal API Token, then configure your MCP client (e.g., Claude for Desktop) to run npx @nazruden/clickup-server. The server communicates via Stdio transport. Optionally install via Smithery with npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude.

Key features of ClickUp MCP Server

Create and update tasks in ClickUp lists.
Manage workspaces, spaces, folders, and boards.
Create, edit, and retrieve docs (Markdown content).
Set and remove custom field values on tasks.
Manage views (list, board, calendar, Gantt) and retrieve view tasks.

Use cases of ClickUp MCP Server

Automate task creation and updates from AI chat.
Search and manage ClickUp docs via natural language.
Create or delete folders/spaces/boards programmatically.
Retrieve and modify custom fields on tasks.
List teams, spaces, folders, and views for reporting.

FAQ from ClickUp MCP Server

How does the server authenticate with ClickUp?

It requires a CLICKUP_PERSONAL_TOKEN environment variable set to a valid ClickUp Personal API Token. The token is passed to the ClickUp API for all requests.

What transport does this server use?

It runs via Stdio transport as per the MCP specification. The server is invoked by an MCP client and communicates over stdin/stdout.

Are there any known limitations?

Yes, ClickUp’s API for Docs (especially v3) does not support direct document deletion; manage Doc lifecycle via archiving or page manipulation. Also, the ENCRYPTION_KEY mechanism is currently not used for encrypting the token in the authentication flow.

What is the server’s runtime requirement?

It requires Node.js and uses npx to run the npm package @nazruden/clickup-server. The server is automatically downloaded and started by the MCP client when needed.

How can I get server logs?

When run via npm run dev or npm start, logs go to the console. When run by an MCP client (e.g., Claude for Desktop), logs are managed by that client and can be found in platform-specific directories as described in the README.

Comments

More Other MCP servers

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

🚀 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