Clickup MCP Sedrver

🚀 ClickUp MCP Server

A Model Context Protocol (MCP) server that provides a standard interface for AI assistants to interact 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

A Model Context Protocol (MCP) server offers a standardized interface for AI assistants to interact with the ClickUp API. It enables AI systems to access and manipulate ClickUp data, covering workspaces, spaces, folders, lists, tasks, documents, comments, and checklists.

✨ Features

Available Tools

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

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 your 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": []
    }
  }
}

⚠️ Important Note

• Ensure the path is correct.
• Make sure to provide your API token.

Alternative Installation (Using npx)

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

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

⚠️ Important Note

• Replace YOUR_API_TOKEN_HERE with your actual API token.
• You don't need to install or clone the repository when using this method.

Configuration File Locations

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

🔧 Technical Details

Build

npm run build

Run Tests

npm test

📄 License

This project is licensed under the MIT License.