Nsxdavid Clickup MCP Server

🚀 ClickUp MCP Server

A Model Context Protocol (MCP) server that provides a standard interface for interacting with the ClickUp API. This server allows AI systems to access and manipulate ClickUp data, including workspaces, spaces, folders, lists, tasks, documents, comments, and checklists.

🚀 Quick Start

The ClickUp MCP server enables AI systems to interact with ClickUp data. Below are the details for getting started.

✨ Features

Available Tools

• get_workspaces: Retrieve a list of workspaces.
• get_spaces: Get spaces within a workspace.
• get_tasks: Fetch tasks from a list.
• create_task: Create a new task.
• update_task: Update an existing task.
• get_docs_from_workspace: Retrieve all documents in 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

Standard Installation

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

Alternative Installation (Using npx)

For users who don't want to clone the repository, you can directly run the package:

{
  "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.

📚 Documentation

Obtain a ClickUp API Token

1. Log in to your ClickUp account.
2. Navigate to Settings > Apps.
3. Click "Generate API Token".
4. Copy the token.

Configuration

Add the following 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": []
    }
  }
}

• Ensure the path is correct.
• Ensure the API token is provided.

Configuration File Location

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

Development

Build

npm run build

Run Tests

npm test

📄 License

This project is licensed under the MIT License.