Clickup Mcp

Model Context Protocol (MCP) server enabling AI assistants to interact with ClickUp workspaces. Get complete task context with comments and images, search across projects, create and update tasks, collaborate through comments, and track time - all through natural language.

See also:Official ClickUp MCP Documentation

- "Look at CU-abc123, can you find the relevant code?"
- "Can you build the dashboard like described inhttps://app.clickup.com/t/12a23b45c?"
- "Check task CU-xyz789 and fix the bugs mentioned in the comments"
- "Implement the API endpoints described in the integration task"

Download the pre-built bundle from ourreleases page. This method requires no Node.js installation.

{ "mcpServers": { "clickup": { "command": "npx", "args": [ "@hauptsache.net/clickup-mcp@latest" ], "env": { "CLICKUP_API_KEY": "your_api_key", "CLICKUP_TEAM_ID": "your_team_id" } } } }

Replaceyour_api_keyandyour_team_idwith your actual ClickUp credentials.

- Claude Desktop: Settings > Developer > Edit Config
- Windsurf: Add to your MCP configuration file
- Cursor: Configure through the MCP settings panel

claude mcp add --scope user clickup \ --env CLICKUP_API_KEY=YOUR_KEY \ --env CLICKUP_TEAM_ID=YOUR_ID \ --env CLICKUP_MCP_MODE=read-minimal \ --env MAX_IMAGES=16 \ --env MAX_RESPONSE_SIZE_MB=4 \ -- npx -y @hauptsache.net/clickup-mcp

Claude Code can handle a lot of images, thus the recommended increased limits.

Note theCLICKUP_MCP_MODE=read-minimal. This is my usage recommendation, but feel free to use one of the other modes.

OpenAI Codex:Add these lines to your~/.codex/config.tomlfile:

[mcp_servers.clickup] command = "npx" args = ["-y", "@hauptsache.net/clickup-mcp@latest"] env = { "CLICKUP_API_KEY" = "YOUR_KEY", "CLICKUP_TEAM_ID" = "YOUR_ID", "CLICKUP_MCP_MODE" = "read-minimal" }

Codex seems to not be able to handle images from MCP's. Seethis issuefor more details.

{ "mcpServers": { "clickup": { "command": "npx", "args": ["-y", "@hauptsache.net/clickup-mcp@latest"], "env": { "CLICKUP_API_KEY": "your_api_key", "CLICKUP_TEAM_ID": "your_team_id", "CLICKUP_MCP_MODE": "read" } } } }

This MCP server can be configured using environment variables. In the desktop extension (.mcpb) installer, the API key, team ID, primary language, upload size limit and comment edit window are offered as form fields; the remaining variables have to be set on the server environment directly.

- CLICKUP_API_KEY: (Required) Your ClickUp API key.
- CLICKUP_TEAM_ID: (Required) Your ClickUp Team ID (formerly Workspace ID).
- CLICKUP_MCP_MODE: (Optional) Controls which tools are available. Options:read-minimal,read,write(default).
- MAX_IMAGES: (Optional) The maximum number of images to return for a task ingetTaskById. Defaults to 4.
- MAX_RESPONSE_SIZE_MB: (Optional) The maximum response size in megabytes forgetTaskById. Uses intelligent size budgeting to fit the most important images within the limit. Defaults to 1.
- MAX_UPLOAD_SIZE_MB: (Optional) The maximum size of a single image uploaded when writing comments or descriptions. Defaults to 10.
- CLICKUP_COMMENT_EDIT_WINDOW_HOURS: (Optional) How long after creationeditCommentmay still rewrite a comment. Defaults to 24. Set to0to disable comment editing entirely.
- CLICKUP_PRIMARY_LANGUAGE: (Optional) A hint for the primary language used in your ClickUp tasks (e.g., "de" for German, "en" for English). This helps thesearchTasktool provide more tailored guidance in its description for multilingual searches.
- LANG: (Optional) IfCLICKUP_PRIMARY_LANGUAGEis not set, the MCP will check this standard environment variable (e.g., "en_US.UTF-8", "de_DE") as a fallback to infer the primary language.

ThesearchTasktool's description will dynamically adjust based on the detected primary language:

- IfCLICKUP_PRIMARY_LANGUAGEorLANGsuggests a known primary language (e.g., German), the tool's description will specifically recommend providing search terms in both English and that detected language (e.g., German) for optimal results.
- If no primary language is detected, a more general recommendation for multilingual workspaces will be provided.

This feature aims to improve search effectiveness when the language of user queries (often English) differs from the language of the tasks in ClickUp, without making the MCP itself perform translations. The responsibility for providing bilingual search terms still lies with the agent calling the MCP, but the MCP offers more specific advice if it has a language hint.

Task descriptions and list documentation support full markdown formatting:

Create a task called "API Integration" with description: # API Integration Requirements ## Authentication - Implement OAuth 2.0 flow - Add JWT token validation - Priority: High security standards ## Endpoints 1. /api/users - User management 2. /api/data - Data retrieval 3. /api/webhook - Event notifications ## Testing - [ ] Unit tests for auth flow - [ ] Integration tests - [ ] Load testing with 1000+ concurrent users > Note: This replaces the legacy REST implementation See related task: https://app.clickup.com/t/abc123

Append-Only Updates (Safe):When updating task descriptions, content is safely appended:

[Existing task description content] --- Edit (2024-01-15): Added new acceptance criteria based on client feedback: - Must support mobile responsive design - Performance requirement: < 2s load time

This ensures no existing content is ever lost while maintaining a clear audit trail.

addComment,editComment,createTaskandupdateTaskaccept images as ordinary markdown. Because this server runs locally, it reads the file itself - so alocal path is enough:

Ist umgesetzt. So sieht es aus: 1. Login öffnen – der Kunde gibt nur seine E-Mail-Adresse ein. 

Accepted sources: local file paths,data:URIs, http(s) URLs (downloaded, then re-uploaded), and existing ClickUp attachment URLs (embedded without re-uploading).

- Prefer paths over base64.A path costs a few tokens; the same screenshot as adata:URI costs roughly 4/3 of its file size in the request.
- The caption becomes the attachment filename, and that filename is what ClickUp displays beneath the image - so write a caption that reads well.
- An image inside a numbered list breaks ClickUp's numbering.Write walkthrough steps as bold lines with the image between them, as above.
- Only real PNG/JPEG/GIF/WebP files are uploaded - the content is checked, not the extension. A file that failsaborts the write:addComment,editCommentandupdateTaskreport every broken reference and change nothing, so the markdown can be fixed and the call retried without creating duplicates.createTaskvalidates its images before creating the task; only an upload failing afterwards is reported as a warning, since the task already exists at that point.
- Attachments always belong to a task, so document pages cannot embed uploads this way.

- Smart Image Processing: Intelligent size budgeting prioritizes the most recent images while respecting both count (MAX_IMAGES, default: 4) and total response size limits (MAX_RESPONSE_SIZE_MB, default: 1MB)
- Search Scope: Searches within the most recent 1000-3000 tasks to prevent running into rate limits (exact number varies by endpoint)
- Search Results: Returns up to 50 most relevant matches to prevent flooding the agent with too many results

- Focused on task-level operations rather than bulk workspace management
- Optimized for conversational AI workflows rather than data migration
- Designed for productivity enhancement, not administrative operations

These limitations ensure reliable performance while covering the most common use cases for both development context and productivity management.

Perform queries and entity operations in your Fibery workspace.

Keep teams & agents coordinated automatically

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.

advanced-math-mcp — MCP server for linear algebra, calculus, and symbolic math. 17 tools with a unified evaluate() expression engine. Supports matrices, eigenvalues, SVD, integrals, limits, derivatives, and more.

An MCP interface for Atlassian products, including Jira and Bitbucket.

The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.

About A repo-native task graph as plain Markdown files, served to AI agents over MCP and to humans over a clean web UI .

Integrate ClickUp with AI applications to manage tasks, spaces, lists, and folders.

Interact with the ClickUp API to manage tasks, lists, and spaces, automating project planning and workflows.