clickup-mcp

{ "dxt_version": "0.1", "name": "@hauptsache.net/clickup-mcp", "display_name": "ClickUp", "version": "1.4.1", "description": "Search, create, and retrieve tasks and documents, add comments, and track time through natural language commands.", "author": { "name": "Marco Pfeiffer", "email": "marco@hauptsache.net", "url": "https://github.com/Nemo64" }, "homepage": "https://www.hauptsache.net", "documentation": "https://github.com/hauptsacheNet/clickup-mcp/blob/main/README.md", "support": "https://github.com/hauptsacheNet/clickup-mcp/issues", "server": { "type": "node", "entry_point": "dist/index.js", "mcp_config": { "command": "node", "args": ["${__dirname}/dist/index.js"], "env": { "CLICKUP_API_KEY": "${user_config.clickup_api_key}", "CLICKUP_TEAM_ID": "${user_config.clickup_team_id}", "CLICKUP_PRIMARY_LANGUAGE": "${user_config.clickup_primary_language}" } } }, "tools": [ { "name": "getTaskById", "description": "Get a ClickUp task with images and comments by ID. Always use this URL when referencing tasks in conversations or sharing with others." }, { "name": "addComment", "description": "Add a comment to a specific task with linking best practices and progress updates." }, { "name": "updateTask", "description": "Update various aspects of an existing task including name, description (append-only), status, priority, dates, tags, assignees, and parent relationships." }, { "name": "createTask", "description": "Create a new task in a specific list with full markdown support, assignment to users, and automatic linking to related tasks." }, { "name": "searchTasks", "description": "Search tasks by name, content, assignees, and ID with fuzzy matching and support for multiple search terms (OR logic). Can filter by list_ids, space_ids, todo status, or tasks assigned to current user." }, { "name": "searchSpaces", "description": "Search spaces (projects) by name or ID with fuzzy matching. Automatically fetches complete tree structure with lists, folders, and documents for 5 or fewer matches." }, { "name": "getListInfo", "description": "Get comprehensive information about a list including description, available statuses, space tags, and project context for task creation." }, { "name": "updateListInfo", "description": "Append documentation or context to a list's description (append-only for safety) with markdown support and timestamp tracking." }, { "name": "getTimeEntries", "description": "Get time entries for a specific task or all user's time entries with hierarchical display (List -> Task -> User -> Entries). Supports date filtering and team member inclusion." }, { "name": "createTimeEntry", "description": "Create a time entry (book time) on a task for the current user using decimal hours format with optional description and start time." }, { "name": "readDocument", "description": "Get a ClickUp document with page structure and content. Supports reading specific pages and provides complete document metadata with navigation." }, { "name": "searchDocuments", "description": "Search documents by name and space with fuzzy matching and support for multiple search terms (OR logic). Can filter by specific space_ids and provides document overview with space context." }, { "name": "writeDocument", "description": "Universal tool for document and page operations with smart document creation. Create new documents, pages, sub-pages, or update existing pages with append mode support for adding content without overwriting." } ], "user_config": { "clickup_api_key": { "type": "string", "title": "ClickUp API Key", "description": "Your ClickUp API key. Get it from Profile → Settings → Apps → API Token", "required": true, "sensitive": true }, "clickup_team_id": { "type": "string", "title": "ClickUp Team ID", "description": "Your ClickUp Team ID (the ~7 digit number in the URL when in settings)", "required": true }, "clickup_primary_language": { "type": "string", "title": "Primary Language", "description": "Primary language hint for search optimization (e.g., 'de' for German, 'en' for English)", "required": false } }, "keywords": [ "clickup", "mcp", "model-context-protocol", "llm", "ai", "ticket", "documents", "time-tracking", "productivity", "project-management", "task-management", "agentic-coding", "automation" ], "license": "MIT", "repository": { "type": "git", "url": "git+https://github.com/hauptsacheNet/clickup-mcp.git" } }