ClickUp MCP Server (Read-Only Version)

Name: ClickUp MCP Server (Read-Only Version)
Author: ToSn0w

@ToSn0w

Repository

About ClickUp MCP Server (Read-Only Version)

No overview available yet

Basic information

Config

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

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

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 (Read-Only Version)?

A read-only Model Context Protocol (MCP) server that integrates ClickUp tasks, spaces, lists, folders, documents, and time tracking with AI applications. It allows AI agents to retrieve information from ClickUp through a standardized protocol.

How to use ClickUp MCP Server (Read-Only Version)?

Install via Smithery (hosted), NPX (local with dependencies), or Docker (containerized). You need a ClickUp API key and Team ID. Configure environment variables (CLICKUP_API_KEY, CLICKUP_TEAM_ID, optionally DOCUMENT_SUPPORT, ENABLE_SSE, PORT, LOG_LEVEL, DISABLED_TOOLS) in your MCP client settings or command line. Then use natural language to query your workspace.

Key features of ClickUp MCP Server (Read-Only Version)

Task information retrieval
Workspace organization viewing (spaces, folders, lists)
Time tracking data access
Member information access
Document content viewing
Built-in rate limiting and error handling

Use cases of ClickUp MCP Server (Read-Only Version)

AI agents fetching task details and statuses
Automating workspace hierarchy exploration
Retrieving time entries and running timers
Searching for workspace members by name or email
Accessing document and page content from ClickUp Docs

FAQ from ClickUp MCP Server (Read-Only Version)

How do I install and configure the server?

Add the NPX command or Docker configuration to your MCP client settings, providing your ClickUp API key and Team ID as environment variables. You can also install via Smithery for a hosted option.

How do I enable document support?

Set the environment variable DOCUMENT_SUPPORT to true. The default is false, and document tools will not be available without this setting.

Can I run the server in SSE (Server-Sent Events) mode?

Yes. Set ENABLE_SSE to true and optionally specify a custom PORT (default 3231). Required for clients that need HTTP-based transport.

How do I disable specific tools?

Use the DISABLED_TOOLS environment variable with a comma‑separated list of tool names (e.g., create_task,delete_task). This helps reduce tool count for context limitations.

What authentication is required?

You must provide a valid ClickUp API key via the CLICKUP_API_KEY environment variable. The server connects to ClickUp’s API using this key and is read‑only.