clickup

This MCP server provides a standardized interface for AI assistants to interact with the ClickUp API. It exposes tools to manage and query ClickUp data such as workspaces, spaces, folders, lists, tasks, docs, comments, and checklists. The server implements functions like get_workspaces, get_spaces, get_tasks, create_task, update_task, get_docs_from_workspace, create_folder, get_lists, and create_list, enabling conversational agents to fetch information and perform common actions within ClickUp. To use it, configure the MCP runtime to point at the server's entry index.js, supplying your ClickUp API token via the CLICKUP_API_TOKEN environment variable. Once running, you can invoke the available tools through your MCP-enabled assistant, passing the required parameters (for example workspace IDs, list IDs, or task details) as per the tool’s interface.

Prerequisites:

• Node.js v18 or newer
• npm (comes with Node.js)

Installation steps:

1. Clone the repository: git clone https://github.com/nsxdavid/clickup-mcp-server.git
2. Navigate into the project: cd clickup-mcp-server
3. Install dependencies: npm install
4. Build the project (if a build step is required by the project configuration): npm run build
5. Create or edit the MCP configuration file (as shown in the README) and supply your ClickUp API token: { "mcpServers": { "clickup": { "command": "node", "args": ["/path/to/clickup-mcp-server/build/index.js"], "env": { "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE" }, "disabled": false, "autoApprove": [] } } }
6. Start the MCP runtime or server container with the configured settings. If you prefer the alternate npx method, you can run via: { "mcpServers": { "clickup": { "command": "npx", "args": ["-y", "clickup-mcp-server"], "env": { "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE" }, "disabled": false, "autoApprove": [] } } }

Notes and tips:

• Ensure the CLICKUP_API_TOKEN is kept secure and not committed to source control.
• The path in mcpServers.clickup.args[0] must point to the compiled server entry (index.js) after build; adjust accordingly.
• If you upgrade dependencies, re-run npm install and rebuild as needed.
• If you encounter authentication errors, verify token scope in ClickUp and that the token is active.
• The npm package name is clickup-mcp-server; you can use npx or install locally as described in the Alternate Installation section.