{
  "markdown": "# ClickUp MCP Pro\n\n> The most complete **ClickUp** MCP server — **161 typed tools + `clickup_raw`** covering the entire ClickUp v2/v3 API. Built to match or beat the paid alternatives, free and open source.\n\n[![npm version](https://img.shields.io/npm/v/clickup-mcp-pro.svg?style=flat-square)](https://www.npmjs.com/package/clickup-mcp-pro)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/helbertparanhos/clickup-mcp-pro?style=flat-square)](https://github.com/helbertparanhos/clickup-mcp-pro/stargazers)\n[![GitHub Forks](https://img.shields.io/github/forks/helbertparanhos/clickup-mcp-pro?style=flat-square)](https://github.com/helbertparanhos/clickup-mcp-pro/network/members)\n[![GitHub Issues](https://img.shields.io/github/issues/helbertparanhos/clickup-mcp-pro?style=flat-square)](https://github.com/helbertparanhos/clickup-mcp-pro/issues)\n[![Glama Quality](https://glama.ai/mcp/servers/helbertparanhos/clickup-mcp-pro/badges/score.svg)](https://glama.ai/mcp/servers/helbertparanhos/clickup-mcp-pro)\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=nodedotjs&logoColor=white)](https://nodejs.org/)\n[![MCP](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-000000?style=flat-square)](https://modelcontextprotocol.io/)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-D97706?style=flat-square)](https://claude.ai/code)\n[![Cursor](https://img.shields.io/badge/Cursor-Compatible-4F46E5?style=flat-square)](https://cursor.sh)\n[![Claude Desktop](https://img.shields.io/badge/Claude%20Desktop-Compatible-D97706?style=flat-square)](https://claude.ai/download)\n\n[![Instagram](https://img.shields.io/badge/@helbertparanhos-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/helbertparanhos)\n[![YouTube](https://img.shields.io/badge/stratacademy-FF0000?style=flat-square&logo=youtube&logoColor=white)](https://www.youtube.com/@stratacademy)\n[![LinkedIn](https://img.shields.io/badge/helbert--paranhos-0077B5?style=flat-square&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/helbert-paranhos/)\n[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=flat-square&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/helbertparanhos)\n[![Strat Academy](https://img.shields.io/badge/Strat%20Academy-8B5CF6?style=flat-square)](https://stratacademy.com.br)\n\nClickUp MCP Pro exposes nearly every ClickUp operation as a typed [Model Context Protocol](https://modelcontextprotocol.io) tool — so Claude Code (and any MCP client) can drive your entire workspace: tasks, lists, folders, spaces, docs, chat, goals, sprints, time tracking, custom fields, webhooks, guests and more. When a niche endpoint isn't wrapped, `clickup_raw` reaches the rest of the API directly, giving you **100% coverage**.\n\n## Highlights\n\n- **161 typed tools** across 23 ClickUp domains (v2 + v3 APIs).\n- **`clickup_raw` escape hatch** — call any endpoint not yet wrapped. Nothing is out of reach.\n- **Readonly mode** (`CLICKUP_READONLY=true`) blocks every write while keeping reads working — safe exploration.\n- **Natural-language dates** — `\"tomorrow\"`, `\"in 3 days\"`, `\"+2h\"`, ISO, or epoch ms all work for any date field.\n- **Name → ID resolution** — `find_member`, `find_space_by_name`, `find_list_by_name`.\n- **Resilient client** — automatic retries with backoff on 429/5xx, `Retry-After` honored, actionable error messages.\n- **Bulk operations** with per-item success/error reporting (partial failures never lose the batch).\n\n## Coverage at a glance\n\n| Domain | Tools | Domain | Tools |\n|--------|:----:|--------|:----:|\n| Workspace / Teams | 6 | Time tracking | 14 |\n| Spaces | 5 | Docs (v3) | 8 |\n| Folders | 7 | Views | 7 |\n| Lists | 9 | Goals & Key Results | 8 |\n| Tasks (core) | 11 | Chat (v3) | 18 |\n| Tasks (bulk) | 4 | Sprints | 3 |\n| Task links & dependencies | 6 | Webhooks | 4 |\n| Comments & threads | 10 | User groups | 4 |\n| Checklists | 6 | Guests (Enterprise) | 10 |\n| Attachments | 2 | Members & resolvers | 5 |\n| Tags | 6 | Templates | 2 |\n| Custom fields | 6 | **`clickup_raw`** | 1 |\n\n## Install & configure\n\n### 1. Get a ClickUp Personal API Token\nClickUp → **Settings → Apps → API Token** (it starts with `pk_`).\n\n### 2. Add to Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clickup-mcp-pro\"],\n      \"env\": {\n        \"CLICKUP_API_TOKEN\": \"pk_your_token_here\",\n        \"CLICKUP_TEAM_ID\": \"9007012345\"\n      }\n    }\n  }\n}\n```\n\nOr, running from source:\n\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"node\",\n      \"args\": [\"d:/GitHub/easypanel-mcp/projects/clickup-mcp-pro/dist/index.js\"],\n      \"env\": { \"CLICKUP_API_TOKEN\": \"pk_your_token_here\" }\n    }\n  }\n}\n```\n\n### 3. Claude Desktop\nFile: `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) or\n`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) — same `mcpServers` block as above.\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n|----------|:-------:|---------|-------------|\n| `CLICKUP_API_TOKEN` | ✅ | — | Personal API token (`pk_...`). `CLICKUP_TOKEN` is also accepted. |\n| `CLICKUP_TEAM_ID` | — | — | Default Team/Workspace id used when a tool omits `team_id`. |\n| `CLICKUP_READONLY` | — | `false` | `true` blocks all writes (reads still work). |\n| `CLICKUP_DISABLE_RAW` | — | `false` | `true` hides the `clickup_raw` tool. |\n| `CLICKUP_UPLOAD_DIR` | — | — | Restrict `upload_task_attachment(file_path)` to this base directory. |\n| `CLICKUP_MAX_UPLOAD_BYTES` | — | `52428800` | Max attachment size (50 MB) for uploads. |\n| `CLICKUP_TIMEOUT_MS` | — | `60000` | Per-request timeout. |\n| `CLICKUP_MAX_RETRIES` | — | `3` | Max retries on 429/5xx/network errors. |\n\n## Security notes\n\nThis server runs locally and acts on behalf of your token, so it's hardened against the usual ways a malicious prompt could abuse a tool call:\n\n- **`upload_task_attachment(url)`** only fetches **HTTPS** URLs and rejects hosts that resolve to private/loopback/link-local addresses (anti-SSRF), following no redirects.\n- **`upload_task_attachment(file_path)`** can be confined to a directory with `CLICKUP_UPLOAD_DIR` to prevent arbitrary local-file exfiltration. Uploads are size-capped (`CLICKUP_MAX_UPLOAD_BYTES`). Note: don't place symlinks pointing outside the directory inside `CLICKUP_UPLOAD_DIR`.\n- **`clickup_raw`** validates the path (must be a clean relative API path — no scheme, host, `..` or `@`) and is blocked for writes under `CLICKUP_READONLY=true`. Set `CLICKUP_DISABLE_RAW=true` to remove it entirely in untrusted environments.\n- The API token is sent only as an auth header and is **never logged** or echoed in error messages.\n\n## Build from source\n\n```bash\ncd projects/clickup-mcp-pro\nnpm install\nnpm run build\n# Inspect interactively:\nnpm run inspector\n```\n\n## Tool reference\n\n### Workspace / Teams\n`get_workspaces`, `get_workspace_seats`, `get_workspace_plan`, `get_workspace_members`, `get_custom_task_types`, `get_authorized_user`\n\n### Spaces\n`list_spaces`, `get_space`, `create_space`, `update_space`, `delete_space`, `get_space_tags`\n\n### Folders\n`list_folders`, `get_folder`, `create_folder`, `create_folder_from_template`, `update_folder`, `delete_folder`, `get_folder_views`\n\n### Lists\n`get_lists_in_folder`, `get_folderless_lists`, `get_list`, `create_list_in_folder`, `create_folderless_list`, `create_list_from_template_in_folder`, `update_list`, `delete_list`, `get_list_views`\n\n### Tasks\n`get_tasks`, `get_task`, `get_workspace_tasks`, `create_task`, `update_task`, `delete_task`, `get_subtasks`, `duplicate_task`, `set_task_custom_field_value`, `remove_task_custom_field_value`, `get_task_members`\nBulk: `create_bulk_tasks`, `update_bulk_tasks`, `delete_bulk_tasks`, `move_bulk_tasks`\nLinks & deps: `add_task_link`, `delete_task_link`, `add_task_dependency`, `delete_task_dependency`, `add_task_to_list`, `remove_task_from_list`\n\n### Comments\n`get_task_comments`, `create_task_comment`, `get_list_comments`, `create_list_comment`, `get_chat_view_comments`, `create_chat_view_comment`, `update_comment`, `delete_comment`, `get_threaded_comments`, `create_threaded_comment`\n\n### Checklists\n`create_checklist`, `edit_checklist`, `delete_checklist`, `create_checklist_item`, `edit_checklist_item`, `delete_checklist_item`\n\n### Attachments\n`upload_task_attachment` (local path / URL / base64), `list_task_attachments`\n\n### Tags & Custom fields\n`get_space_tags`, `create_space_tag`, `update_space_tag`, `delete_space_tag`, `add_tag_to_task`, `remove_tag_from_task`\n`get_list_custom_fields`, `get_folder_custom_fields`, `get_space_custom_fields`, `get_workspace_custom_fields`, `set_custom_field_value`, `remove_custom_field_value`\n\n### Time tracking\n`get_time_entries`, `get_time_entry`, `get_running_time_entry`, `start_time_entry`, `stop_time_entry`, `create_time_entry`, `update_time_entry`, `delete_time_entry`, `get_time_entry_history`, `get_all_time_entry_tags`, `add_tags_to_time_entries`, `remove_tags_from_time_entries`, `get_task_time_in_status`, `get_bulk_tasks_time_in_status`\n\n### Docs (v3)\n`search_docs`, `get_doc`, `create_doc`, `get_doc_page_listing`, `get_doc_pages`, `get_doc_page`, `create_doc_page`, `update_doc_page` (replace/append/prepend)\n\n### Views\n`get_team_views`, `get_space_views`, `get_view`, `get_view_tasks`, `create_view`, `update_view`, `delete_view`\n\n### Goals\n`get_goals`, `get_goal`, `create_goal`, `update_goal`, `delete_goal`, `create_key_result`, `update_key_result`, `delete_key_result`\n\n### Chat (v3)\n`list_chat_channels`, `get_chat_channel`, `create_chat_channel`, `create_chat_channel_on_location`, `create_chat_direct_message`, `update_chat_channel`, `get_chat_channel_members`, `get_chat_channel_followers`, `get_chat_messages`, `send_chat_message`, `update_chat_message`, `delete_chat_message`, `get_chat_message_replies`, `create_chat_message_reply`, `get_chat_message_reactions`, `create_chat_message_reaction`, `delete_chat_message_reaction`, `get_chat_message_tagged_users`\n\n### Sprints / Webhooks / User groups / Guests / Templates\n`list_sprints`, `get_active_sprint`, `get_sprint_tasks`\n`list_webhooks`, `create_webhook`, `update_webhook`, `delete_webhook`\n`list_user_groups`, `create_user_group`, `update_user_group`, `delete_user_group`\n`invite_guest`, `get_guest`, `edit_guest`, `remove_guest`, `add_guest_to_task`, `remove_guest_from_task`, `add_guest_to_list`, `remove_guest_from_list`, `add_guest_to_folder`, `remove_guest_from_folder`\n`get_task_templates`, `create_task_from_template`\n\n### Members & resolvers\n`get_task_assignable_members`, `get_list_members`, `find_member`, `find_space_by_name`, `find_list_by_name`\n\n### Escape hatch\n`clickup_raw` — call any ClickUp v2/v3 endpoint directly. Example:\n```json\n{ \"method\": \"GET\", \"path\": \"/team/9007012345/space\", \"version\": \"v2\" }\n```\n\n## How it compares\n\n| | ClickUp MCP Pro | taazkareem (paid) | Nazruden | DiversioTeam |\n|---|:--:|:--:|:--:|:--:|\n| Typed tools | **161** | ~150 | ~30 | ~28 |\n| Raw escape hatch | ✅ | — | — | — |\n| Readonly mode | ✅ | — | — | — |\n| Chat / Goals / Sprints | ✅ | ✅ | — | — |\n| Docs (v3) | ✅ | ✅ | ✅ | — |\n| Time tracking | ✅ | ✅ | — | partial |\n| Price | **Free / MIT** | Paid | Free | Free |\n\n## License\n\nMIT © Helbert Paranhos / [Strat Academy](https://stratacademy.com.br)\n\n- GitHub: [@helbertparanhos](https://github.com/helbertparanhos)\n- Built with the [Strat Builder](https://github.com/helbertparanhos) meta-system.\n",
  "bytes": 11728,
  "sha": "351d834de85d1752e26950489979e39de5cab81006fbbb7cae1dca39cc2b6624",
  "repo_slug": "helbertparanhos/clickup-mcp-pro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_helbertparanhos_clickup_mcp_pr_5873405b/readme"
}