clickup MCP Server

Use This MCP server To

Access ClickUp tasks and project data via AI Create and update ClickUp tasks programmatically Retrieve and manage ClickUp comments and docs Automate ClickUp workspace and folder organization Integrate ClickUp data into AI-driven project management tools Sync ClickUp checklists with AI task tracking Generate task summaries from ClickUp data Trigger workflows based on ClickUp task status changes

README

ClickUp MCP Server

ClickUp MCP Server Logo

A Model Context Protocol (MCP) server that provides a standardized interface for AI assistants to interact with the ClickUp API. This server enables AI systems to access and manipulate ClickUp data such as workspaces, spaces, folders, lists, tasks, docs, comments, and checklists.

Available Tools

get_workspaces: Get the list of workspaces
get_spaces: Get spaces within a workspace
get_tasks: Get tasks from a list
create_task: Create a new task
update_task: Update an existing task
get_docs_from_workspace: Get all docs from a workspace
create_folder: Create a new folder in a space
get_lists: Get lists in a folder or space
create_list: Create a new list

Installation

git clone https://github.com/nsxdavid/clickup-mcp-server.git
cd clickup-mcp-server
npm install

Get ClickUp API Token

Log in to ClickUp account
Go to Settings > Apps
Click "Generate API Token"
Copy the token

Configuration

Add to the MCP settings file:

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp-server/build/index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Make sure to correct the path
Make sure to supply your API token

Alternate Installation (npx)

For users who prefer not to clone the repository, the package can be run directly using npx:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "clickup-mcp-server"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Replace YOUR_API_TOKEN_HERE with your API token
No installation or cloning is required with this method

Configuration File Locations

Cline VSCode Extension: ~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Claude Desktop Apps:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Development

Building

npm run build

Running Tests

npm test

License

MIT

clickup-mcp-server FAQ

How do I authenticate the ClickUp MCP Server?

Authentication is done via ClickUp API tokens, which you configure in the server settings to securely connect your ClickUp workspace.

Can the ClickUp MCP Server handle real-time updates?

It supports polling and webhook integration to keep AI models updated with the latest ClickUp data.

What ClickUp entities can the MCP Server access?

It can access workspaces, spaces, folders, lists, tasks, docs, comments, and checklists within ClickUp.

Is the ClickUp MCP Server compatible with multiple MCP clients?

Yes, it follows the MCP standard, making it interoperable with any MCP-compliant client.

What Node.js version is required to run the ClickUp MCP Server?

Node.js version 18.0.0 or higher is required.

How does the ClickUp MCP Server ensure data security?

It uses secure API token management and scoped permissions to protect your ClickUp data.

Can I extend the ClickUp MCP Server functionality?

Yes, it is open source under the MIT license, allowing customization and extension.

Does the server support batch operations on ClickUp tasks?

Yes, it supports batch retrieval and updates to optimize performance.