# clickup

Connects ClickUp workspaces to coding assistants for managing tasks, sprints, and time tracking. Keeps project management inside the terminal.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 53
- Author: taazkareem
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/taazkareem/clickup-mcp-server
- Updated: 2026-10-11
- HTML: https://affpapa.org/en/nevibecode/mcp/clickup

## What it does

This MCP server links AI agents directly to ClickUp workspaces. It handles task operations, from setting up dependencies and nested subtasks to uploading attachments via local paths or base64. The server runs fuzzy matching across spaces, folders, and custom statuses. You can reference items by plain text names instead of hunting for raw IDs.

Time tracking tools are built in. An agent can start or stop timers, log hours manually, and pull historical records filtered by natural language dates.

A valid `CLICKUP_MCP_LICENSE_KEY` is required because this package uses a proprietary license. Running it also demands your `CLICKUP_API_KEY` and `CLICKUP_TEAM_ID` set in the environment.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CLICKUP_MCP_LICENSE_KEY`, `CLICKUP_API_KEY`, `CLICKUP_TEAM_ID`, `DOCUMENT_SUPPORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CLICKUP_MCP_LICENSE_KEY=<CLICKUP_MCP_LICENSE_KEY> --env CLICKUP_API_KEY=<CLICKUP_API_KEY> --env CLICKUP_TEAM_ID=<CLICKUP_TEAM_ID> --env DOCUMENT_SUPPORT=<DOCUMENT_SUPPORT> --transport stdio clickup -- npx -y @taazkareem/clickup-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add clickup --env CLICKUP_MCP_LICENSE_KEY=<CLICKUP_MCP_LICENSE_KEY> --env CLICKUP_API_KEY=<CLICKUP_API_KEY> --env CLICKUP_TEAM_ID=<CLICKUP_TEAM_ID> --env DOCUMENT_SUPPORT=<DOCUMENT_SUPPORT> -- npx -y @taazkareem/clickup-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clickup": {
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server"
            ],
            "env": {
                "CLICKUP_MCP_LICENSE_KEY": "<CLICKUP_MCP_LICENSE_KEY>",
                "CLICKUP_API_KEY": "<CLICKUP_API_KEY>",
                "CLICKUP_TEAM_ID": "<CLICKUP_TEAM_ID>",
                "DOCUMENT_SUPPORT": "<DOCUMENT_SUPPORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "clickup": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@taazkareem/clickup-mcp-server"
            ],
            "env": {
                "CLICKUP_MCP_LICENSE_KEY": "<CLICKUP_MCP_LICENSE_KEY>",
                "CLICKUP_API_KEY": "<CLICKUP_API_KEY>",
                "CLICKUP_TEAM_ID": "<CLICKUP_TEAM_ID>",
                "DOCUMENT_SUPPORT": "<DOCUMENT_SUPPORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CLICKUP_MCP_LICENSE_KEY=<CLICKUP_MCP_LICENSE_KEY> -e CLICKUP_API_KEY=<CLICKUP_API_KEY> -e CLICKUP_TEAM_ID=<CLICKUP_TEAM_ID> -e DOCUMENT_SUPPORT=<DOCUMENT_SUPPORT> clickup npx -y @taazkareem/clickup-mcp-server
```
Replace <…> with your own values

## When to use it
- start or stop task timers and log work hours directly from chat
- create tasks with dependencies, checklists, and file attachments
- search folders, lists, and statuses without looking up numeric IDs
- review active sprints and update task progress

## Example prompts
- Create a bug fix task in the current sprint and attach error.log
- Start the timer for my active task on backend refactoring
- Find all tasks in the Frontend list with status In Progress

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md