{"_id":"@azukhrufy/clickup-mcp-server","name":"@azukhrufy/clickup-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@azukhrufy/clickup-mcp-server","version":"1.0.0","description":"MCP server for ClickUp - full API integration with Docs CRUD (create, read, update, delete) and complete ClickUp API access","type":"module","main":"build/index.js","bin":{"clickup-mcp-server":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","dev":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"keywords":["mcp","clickup","model-context-protocol","cline","claude","docs","tasks"],"author":{"name":"azukhrufy"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/azukhrufy/clickup-mcp-server.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","axios":"^1.7.9"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"_id":"@azukhrufy/clickup-mcp-server@1.0.0","gitHead":"b2ed96fac89c05dfe1c8cc9d5ebd75589e813250","types":"./build/index.d.ts","bugs":{"url":"https://github.com/azukhrufy/clickup-mcp-server/issues"},"homepage":"https://github.com/azukhrufy/clickup-mcp-server#readme","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-NPUiN8e80dXX7qGmaEg103UYI50QKN+eunDOxd+S7yXFn06qZ1s8fpvcyX7j/IUVhuN0aak8W5GpiBTGIixIdA==","shasum":"c33afa0b7eac17cbbf4a70c11b93077b66ef4d73","tarball":"https://registry.npmjs.org/@azukhrufy/clickup-mcp-server/-/clickup-mcp-server-1.0.0.tgz","fileCount":11,"unpackedSize":321266,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAW75f64BJxGq9XOa+qu4DN/vXJaz4m6lpWgedPfra/uAiEA3k6oO7/bbnY7V3T1ZPc54j6O3seJo30Uqszjefh10d0="}]},"_npmUser":{"name":"azukhrufy","email":"anandazukhrufawalwi@gmail.com"},"directories":{},"maintainers":[{"name":"azukhrufy","email":"anandazukhrufawalwi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clickup-mcp-server_1.0.0_1785849570638_0.7306439042686581"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-04T13:19:30.495Z","1.0.0":"2026-08-04T13:19:30.795Z","modified":"2026-08-04T13:19:31.031Z"},"maintainers":[{"name":"azukhrufy","email":"anandazukhrufawalwi@gmail.com"}],"description":"MCP server for ClickUp - full API integration with Docs CRUD (create, read, update, delete) and complete ClickUp API access","homepage":"https://github.com/azukhrufy/clickup-mcp-server#readme","keywords":["mcp","clickup","model-context-protocol","cline","claude","docs","tasks"],"repository":{"type":"git","url":"git+https://github.com/azukhrufy/clickup-mcp-server.git"},"author":{"name":"azukhrufy"},"bugs":{"url":"https://github.com/azukhrufy/clickup-mcp-server/issues"},"license":"MIT","readme":"# ClickUp MCP Server\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that provides comprehensive access to the [ClickUp API](https://clickup.com/api) — enabling AI assistants like Cline, Claude Code, and others to read, write, update, and delete ClickUp documentation, plus access the full ClickUp API surface.\n\n## ✨ Features\n\n### 📄 Docs Management (v3 API)\nFull CRUD operations on ClickUp Docs and Pages:\n- `get_docs` / `get_doc` / `get_doc_pages` / `get_doc_page` — Read docs & pages\n- `create_doc` / `create_doc_page` — Create docs & pages\n- `update_doc` / `update_doc_page` — Update docs & pages\n- `delete_doc` / `delete_doc_page` — Delete docs & pages\n- `get_doc_blocks` / `create_doc_blocks` / `update_doc_blocks` / `delete_doc_blocks` — Block-level editing\n\n### 🗂️ Full ClickUp API Coverage (84+ tools)\n- **Workspaces**: Get teams & workspace details\n- **Spaces**: Full CRUD for spaces\n- **Folders**: Full CRUD for folders\n- **Lists**: Full CRUD for lists\n- **Tasks**: Full CRUD, filtering, status updates, assignees, tags\n- **Comments**: Read/create/update/delete on tasks & lists\n- **Checklists**: Full CRUD for checklists & items\n- **Members**: View & invite team members\n- **Goals**: Full CRUD for goals\n- **Time Tracking**: View/create/delete time entries\n- **Views**: Read views at any level\n- **Webhooks**: Full CRUD for webhooks\n- **Tags**: Full CRUD for space tags\n- **Custom Fields**: Read & set custom field values\n- **Task Templates**: Read/create/delete templates\n- **Plus**: Task relationships, links, dependencies, attachments, guests, roles, shared hierarchy\n\n## 📦 Installation\n\n### ⚡ Cara Tercepat: Install Langsung via Cline (Paste Link GitHub)\n\nSetelah repo ini di-push ke GitHub, kamu bisa langsung install MCP server ini ke Cline dengan cara:\n\n1. **Copy link GitHub repo** ini, contoh:\n   ```\n   https://github.com/azukhrufy/clickup-mcp-server\n   ```\n\n2. **Paste link tersebut ke Cline** dan beri perintah seperti ini:\n   ```\n   Install MCP server dari repo ini: https://github.com/azukhrufy/clickup-mcp-server\n   ```\n   atau\n   ```\n   Tambahkan MCP server ClickUp dari https://github.com/azukhrufy/clickup-mcp-server\n   ```\n\n3. **Cline akan otomatis:**\n   - Clone repo ke folder MCP servers\n   - Install dependencies (`npm install`)\n   - Build project (`npm run build`)\n   - Menambahkan konfigurasi ke `cline_mcp_settings.json`\n\n4. **Masukkan ClickUp API Token** saat diminta (lihat bagian [Konfigurasi](#-konfigurasi))\n\n5. **Restart Cline** — tools ClickUp akan muncul di panel MCP servers\n\n### 📦 Install Langsung dari GitHub (Tanpa Path Lokal)\n\nCara ini langsung mengarah ke link GitHub — **tidak perlu path lokal**. `npx` akan otomatis clone, install, build, dan jalankan dari repo GitHub.\n\nKonfigurasi di `cline_mcp_settings.json`:\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"github:azukhrufy/clickup-mcp-server\"],\n      \"env\": {\n        \"CLICKUP_API_TOKEN\": \"pk_your_api_token_here\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n**Untuk branch tertentu:**\n```json\n{\n  \"args\": [\"-y\", \"github:azukhrufy/clickup-mcp-server#branch-name\"]\n}\n```\n\n### 📦 Install via npx (Setelah di-publish ke npm)\n\n```bash\n# Langsung jalankan tanpa clone\nnpx clickup-mcp-server\n```\n\nKonfigurasi di `cline_mcp_settings.json`:\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clickup-mcp-server\"],\n      \"env\": {\n        \"CLICKUP_API_TOKEN\": \"pk_your_api_token_here\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n### 📦 Install Manual (Clone)\n\n```bash\n# Clone the repository\ngit clone https://github.com/azukhrufy/clickup-mcp-server.git\ncd clickup-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the server\nnpm run build\n```\n\n## 🔑 Configuration\n\n### 1. Get a ClickUp API Token\n1. Log in to [ClickUp](https://app.clickup.com)\n2. Go to **Settings → Apps** (or [https://app.clickup.com/settings/apps](https://app.clickup.com/settings/apps))\n3. Click **Generate** under the API Token section\n4. Copy the token (starts with `pk_` for Personal Tokens)\n\n### 2. Add to Cline (VS Code)\nAdd the MCP server to your Cline settings file:\n`~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/clickup-mcp-server/build/index.js\"],\n      \"env\": {\n        \"CLICKUP_API_TOKEN\": \"pk_your_api_token_here\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n### 3. Add to Claude Desktop\nEdit `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/clickup-mcp-server/build/index.js\"],\n      \"env\": {\n        \"CLICKUP_API_TOKEN\": \"pk_your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n## 🚀 Usage\n\n### Reading a ClickUp Doc\nClickUp doc URLs follow this format:\n```\nhttps://app.clickup.com/{team_id}/v/dc/{doc_id}/{page_id}\n```\n\nExample with the Cline tools:\n```\nget_doc_page(team_id=\"36768531\", doc_id=\"1322rk-9596\", page_id=\"1322rk-32376\")\n```\n\n### Example prompts you can ask your AI assistant:\n- \"List my ClickUp workspaces\"\n- \"Get all docs in my workspace\"  \n- \"Read the contents of doc XYZ page 123\"\n- \"Create a new doc called 'Meeting Notes'\"\n- \"Update the status of task ABC to 'in progress'\"\n- \"Create a checklist on task DEF\"\n\n## 🛠️ Development\n\n```bash\n# Watch mode for development\nnpm run dev\n\n# Build TypeScript\nnpm run build\n```\n\n## 📁 Project Structure\n\n```\nclickup-mcp-server/\n├── src/\n│   ├── index.ts          # MCP server implementation (tool definitions & handlers)\n│   └── clickup-api.ts    # ClickUp API v2 + v3 client wrapper\n├── build/                # Compiled JavaScript output\n├── tsconfig.json\n├── package.json\n└── README.md\n```\n\n## 🔧 Architecture Notes\n\n- **Dual API clients**: The server uses ClickUp's **v2 API** for standard endpoints (teams, spaces, tasks, etc.) and **v3 API** for Docs endpoints (`/workspaces/{team_id}/docs/...`)\n- **Stdio transport**: Communication happens over standard input/output\n- **TypeScript**: Full type safety with strict mode\n- **Error handling**: Standardized error messages with HTTP status codes\n\n## 📄 License\n\nMIT\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests.","readmeFilename":"README.md","_rev":"1-59153b8c681d03c5a275a0f12f0c8bc7"}