{"id":26718572,"url":"https://github.com/taazkareem/clickup-mcp-server","last_synced_at":"2026-01-19T21:47:54.624Z","repository":{"id":330781378,"uuid":"1122513274","full_name":"taazkareem/clickup-mcp-server","owner":"taazkareem","description":"ClickUp MCP Server - Integrate ClickUp project management with AI through Model Context Protocol","archived":false,"fork":false,"pushed_at":"2026-01-18T09:06:42.000Z","size":9081,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T17:29:45.982Z","etag":null,"topics":["ai","antigravity-ide","artificial-intelligence","claude-code","claude-desktop","clickup","clickup-api","cursor-ai","lists","llm","mcp","mcp-server","model-context-protocol","productivity","project-management","roo-code","spaces","task-management","tasks","workspaces"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taazkareem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security-features.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T22:49:26.000Z","updated_at":"2026-01-18T09:06:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/taazkareem/clickup-mcp-server","commit_stats":null,"previous_names":["taazkareem/clickup-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/taazkareem/clickup-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taazkareem%2Fclickup-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taazkareem%2Fclickup-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taazkareem%2Fclickup-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taazkareem%2Fclickup-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taazkareem","download_url":"https://codeload.github.com/taazkareem/clickup-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taazkareem%2Fclickup-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28579008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T17:42:58.221Z","status":"ssl_error","status_checked_at":"2026-01-19T17:40:54.158Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","antigravity-ide","artificial-intelligence","claude-code","claude-desktop","clickup","clickup-api","cursor-ai","lists","llm","mcp","mcp-server","model-context-protocol","productivity","project-management","roo-code","spaces","task-management","tasks","workspaces"],"created_at":"2025-03-27T17:35:11.581Z","updated_at":"2026-01-19T21:47:54.618Z","avatar_url":"https://github.com/taazkareem.png","language":"Dockerfile","funding_links":["https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW","https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5"],"categories":["📚 Projects (1974 total)","Task and Project Management","Productivity","Communication","MCP Servers"],"sub_categories":["MCP Servers","Project Management","How to Submit","Other MCP Servers"],"readme":"# ClickUp MCP Server\n![ClickUp MCP Server Premium Image](https://raw.githubusercontent.com/taazkareem/clickup-mcp-server/main/assets/images/header_image.png)\n\n[![npm version](https://img.shields.io/npm/v/@taazkareem/clickup-mcp-server.svg)](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/@taazkareem/clickup-mcp-server.svg)](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)\n[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)\n[![Maintained](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity)\n\n**Connect ClickUp to AI Agents including Claude Desktop, Cursor IDE, n8n, and Gemini CLI.**\n*A high-performance Model Context Protocol (MCP) server for managing tasks, tags, lists, folders, files, docs, time, and chat using natural language.*\n\n\u003e **Status Update:** Latest (v0.12.4) update fixes Markdown Description support for the `get_task` tool to intelligently improve High-Fidelity Context.\n\n⭐️ 460+ Stars (from previous public repo) - Industry-Standard ClickUp MCP Integration\n\u003chr\u003e\n\n\n## 💎 Premium Access\n\n**This project operates on a Sponsorware model.** To ensure dedicated maintenance, rapid API updates, and priority support, the source code and latest builds are exclusively available to supporters.\n\n| **[Monthly Subscription ($9)](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW)** | **[Lifetime Access ($59)](https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5)** |\n| :--- | :--- |\n| • Perfect for ongoing projects\u003cbr\u003e• Cancel anytime | • Pay once, use forever\u003cbr\u003e• Best value for agencies |\n\n\u003e **Instant Access:** Licenses are delivered immediately via **Polar.sh**. Setup takes \u003c 2 minutes.\n\n---\n\n## 🚀 Quick Start\n\n### 1. Prerequisites\n*   **Node.js v18.0.0+**\n*   **License Key:** [Purchase here](https://buy.polar.sh/polar_cl_whcMn4lbBFwZUoWU5p2qDSn0fs23ACC6IwK3e15hXV5)\n*   **ClickUp Credentials:** API Key \u0026 Team ID\n\n### 2. Configure MCP Client\nAdd the following to your `claude_desktop_config.json` or similar MCP settings file:\n\n```json\n{\n  \"mcpServers\": {\n    \"ClickUp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@taazkareem/clickup-mcp-server@latest\"\n      ],\n      \"env\": {\n        \"CLICKUP_MCP_LICENSE_KEY\": \"your-license-key-here\",\n        \"CLICKUP_API_KEY\": \"your-clickup-api-key\",\n        \"CLICKUP_TEAM_ID\": \"your-team-id\",\n        \"DOCUMENT_SUPPORT\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart\nRestart your MCP Host (e.g., Cursor IDE). The server will validate your license and start automatically.\n\n---\n\n## ✨ Features\n\nIntegrate ClickUp seamlessly with Natural Language for customized workflows\n\n*   **📝 Task Management:** Create, update, move, duplicate, and link tasks. Supports bulk operations and natural language dates.\n*   **⏱️ Time Tracking:** Start/stop timers, view entries, and manage billable time.\n*   **📄 Docs \u0026 Knowledge:** Create, read, and append to ClickUp Documents. Full workspace hierarchy traversal.\n*   **💬 Chat \u0026 Collaboration:** Send messages to channels, read history, and manage comments with Markdown support.\n*   **🌳 Workspace Control:** Navigate spaces, folders, and lists. Manage tags and member assignments.\n\n---\n\n## ⚙️ Configuration\n\n### Finding Your Credentials\n\n1.  **ClickUp API Key:**\n    *   Navigate to [ClickUp Settings → Apps](https://app.clickup.com/settings/apps).\n    *   Generate a token under \"API Token\".\n2.  **ClickUp Team ID:**\n    *   Open ClickUp in your browser.\n    *   Look at the URL: `https://app.clickup.com/[TEAM_ID]/v/...`\n    *   The first number is your Team ID.\n    *   *Note: ClickUp API calls this `team_id`, but it actually represents your Workspace ID.*\n\n### Tool Filtering (Optional)\nReduce context noise by limiting available tools. Add this to your `env` configuration:\n\n```json\n\"ENABLED_TOOLS\": \"create_task,get_task,update_task,get_workspace_hierarchy\"\n```\n\n---\n\n## 🛠️ Available Tools\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e👇 Click to view all 50+ available tools\u003c/strong\u003e\u003c/summary\u003e\n\n| Category | Tool | Description |\n| :--- | :--- | :--- |\n| **Workspace** | `get_workspace_hierarchy` | Get workspace structure |\n| | `get_workspace_members` | Get all workspace members |\n| | `find_member_by_name` | Find member by name or email |\n| **Tasks** | `create_task` | Create a task |\n| | `create_bulk_tasks` | Create multiple tasks |\n| | `update_task` | Modify task |\n| | `update_bulk_tasks` | Update multiple tasks |\n| | `get_tasks` | Get tasks from list |\n| | `get_task` | Get single task details |\n| | `get_workspace_tasks` | Get tasks with filtering |\n| | `delete_task` | Remove task |\n| | `move_task` | Move task to new list |\n| | `duplicate_task` | Copy task |\n| | `add_task_link` | Link two tasks together |\n| **Comments** | `get_task_comments` | Get comments on a task |\n| | `create_task_comment` | Add a comment to a task |\n| | `attach_task_file` | Attach file to a task |\n| **Lists/Folders** | `create_list` | Create list in space/folder |\n| | `create_folder` | Create folder |\n| | `get_folder` | Get folder details |\n| | `update_folder` | Update folder properties |\n| **Tags** | `get_space_tags` | Get space tags |\n| | `create_space_tag` | Create tag |\n| | `add_tag_to_task` | Add tag to task |\n| **Time** | `start_time_tracking` | Start time tracking |\n| | `stop_time_tracking` | Stop current time tracking |\n| | `get_task_time_entries` | Get time entries for a task |\n| **Docs** | `create_document` | Create a document |\n| | `get_document` | Get a document |\n| | `list_documents` | List documents |\n| **Chat** | `create_chat_channel` | Create a chat channel |\n| | `create_chat_message` | Send a message to a channel |\n| | `get_chat_messages` | Get message history |\n\n*See [full documentation](docs/user-guide.md) for parameters and advanced usage.*\n\u003c/details\u003e\n\n---\n\n## 🔌 Compatibility\n\nThis server supports  **STDIO, HTTP Streamable, and SSE (Server-Sent Events)** for legacy integrations.\n\n**Configuration:**\n```json\n{\n  \"env\": {\n    \"ENABLE_SSE\": \"true\",\n    \"PORT\": \"3231\"\n  }\n}\n```\n\n**n8n Setup:**\n1.  Set `ENABLE_SSE` to \"true\" and run the server.\n2.  In n8n, add an **\"MCP AI Tool\"** node.\n3.  Set Transport to `SSE` and URL to `http://localhost:3231/sse`.\n\n---\n\n## ❓ FAQ\n\n**Why isn't this free anymore?**\nBuilding reliable MCP integrations requires significant maintenance. Moving to a paid model allows us to support this as a product rather than a hobby, ensuring compatibility with API changes.\n\n**I have an old version. Will it stop working?**\nExisting local clones will continue to work, but you will not receive updates, bug fixes, or support without a license.\n\n**How do I get support?**\nPremium users get priority support. Please [open an issue](https://github.com/TaazKareem/clickup-mcp-server/issues) in this repository.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eCreated by \u003ca href=\"https://github.com/taazkareem\"\u003etaazkareem\u003c/a\u003e\u003c/sub\u003e\n  \u003cbr\u003e\n  \u003csub\u003eThis project is an independent work and is not officially associated with or sponsored by ClickUp.\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaazkareem%2Fclickup-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaazkareem%2Fclickup-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaazkareem%2Fclickup-mcp-server/lists"}