clickup — Claude Code MCP server: what it does, how to install
Connects ClickUp workspaces to coding assistants for managing tasks, sprints, and time tracking. Keeps project management inside the terminal.
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-serverWhat clickup 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.
What it helps with
- 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 for the agent
- 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
How to install clickup
Platform CLI
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-serverReplace <…> with your own values
Platform CLI
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-serverReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about clickup
How to install clickup in Claude Code?
Run `claude mcp add clickup -e CLICKUP_MCP_LICENSE_KEY=<CLICKUP_MCP_LICENSE_KEY> -e CLICKUP_API_KEY=<CLICKUP_API_KEY> -e CLICKUP_TEAM_ID=<CLICKUP_TEAM_ID> -- npx -y @taazkareem/clickup-mcp-server`.
What does the clickup MCP server do?
It lets AI assistants manage ClickUp tasks, track logged time, and handle sprint items using text instructions. It also resolves workspace items by name using fuzzy search.
What credentials are required to run this server?
You must provide CLICKUP_MCP_LICENSE_KEY, CLICKUP_API_KEY, and CLICKUP_TEAM_ID. You can also supply DOCUMENT_SUPPORT if your setup requires document features.
