@rigo-m/clickup-mcp-server
Advanced tools
ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol
A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
🚀 Status Update: v0.7.2 now available with complete Time Tracking support and Document Management features.
The server is hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app.
Add this entry to your client's MCP settings JSON file:
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"DOCUMENT_SUPPORT": "true"
}
}
}
}
Or use this npx command:
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
Obs: if you don't pass "DOCUMENT_SUPPORT": "true", the default is false and document support will not be active.
Additionally, you can use the DISABLED_TOOLS environment variable or --env DISABLED_TOOLS argument to disable specific tools. Provide a comma-separated list of tool names to disable (e.g., create_task,delete_task).
Please disable tools you don't need if you are having issues with the number of tools or any context limitations
| 📝 Task Management | 🏷️ Tag Management |
|---|---|
| • Create, update, and delete tasks • Move and duplicate tasks anywhere • Support for single and bulk operations • Set start/due dates with natural language • Create and manage subtasks • Add comments and attachments | • Create, update, and delete space tags • Add and remove tags from tasks • Use natural language color commands • Automatic contrasting foreground colors • View all space tags • Tag-based task organization across workspace |
| ⏱️ Time Tracking | 🌳 Workspace Organization |
| • View time entries for tasks • Start/stop time tracking on tasks • Add manual time entries • Delete time entries • View currently running timer • Track billable and non-billable time | • Navigate spaces, folders, and lists • Create and manage folders • Organize lists within spaces • Create lists in folders • View workspace hierarchy • Efficient path navigation |
| 📄 Document Management | ⚡ Integration Features |
| • Document Listing through all workspace • Document Page listing • Document Page Details • Document Creation • Document page update (append & prepend) | • Global name or ID-based lookups • Case-insensitive matching • Markdown formatting support • Built-in rate limiting • Error handling and validation • Comprehensive API coverage |
| Tool | Description | Required Parameters |
|---|---|---|
| get_workspace_hierarchy | Get workspace structure | None |
| create_task | Create a task | name, (listId/listName) |
| create_bulk_tasks | Create multiple tasks | tasks[] |
| update_task | Modify task | taskId/taskName |
| update_bulk_tasks | Update multiple tasks | tasks[] with IDs or names |
| get_tasks | Get tasks from list | listId/listName |
| get_task | Get single task details | taskId/taskName (with smart disambiguation) |
| get_workspace_tasks | Get tasks with filtering | At least one filter (tags, list_ids, space_ids, etc.) |
| get_task_comments | Get comments on a task | taskId/taskName |
| create_task_comment | Add a comment to a task | commentText, (taskId/(taskName+listName)) |
| attach_task_file | Attach file to a task | taskId/taskName, (file_data or file_url) |
| delete_task | Remove task | taskId/taskName |
| delete_bulk_tasks | Remove multiple tasks | tasks[] with IDs or names |
| move_task | Move task | taskId/taskName, listId/listName |
| move_bulk_tasks | Move multiple tasks | tasks[] with IDs or names, target list |
| duplicate_task | Copy task | taskId/taskName, listId/listName |
| create_list | Create list in space | name, spaceId/spaceName |
| create_folder | Create folder | name, spaceId/spaceName |
| create_list_in_folder | Create list in folder | name, folderId/folderName |
| get_folder | Get folder details | folderId/folderName |
| update_folder | Update folder properties | folderId/folderName |
| delete_folder | Delete folder | folderId/folderName |
| get_list | Get list details | listId/listName |
| update_list | Update list properties | listId/listName |
| delete_list | Delete list | listId/listName |
| get_space_tags | Get space tags | spaceId/spaceName |
| create_space_tag | Create tag | tagName, spaceId/spaceName |
| update_space_tag | Update tag | tagName, spaceId/spaceName |
| delete_space_tag | Delete tag | tagName, spaceId/spaceName |
| add_tag_to_task | Add tag to task | tagName, taskId/(taskName+listName) |
| remove_tag_from_task | Remove tag from task | tagName, taskId/(taskName+listName) |
| get_task_time_entries | Get time entries for a task | taskId/taskName |
| start_time_tracking | Start time tracking on a task | taskId/taskName |
| stop_time_tracking | Stop current time tracking | None |
| add_time_entry | Add manual time entry to a task | taskId/taskName, start, duration |
| delete_time_entry | Delete a time entry | timeEntryId |
| get_current_time_entry | Get currently running timer | None |
| create_document | Create a document | workspaceId, name, parentId/parentType, visibility, create_pages |
| get_document | Get a document | workspaceId/documentId |
| list_documents | List documents | workspaceId, documentId/creator/deleted/archived/parent_id/parent_type/limit/next_cursor |
| list_document_pages | List document pages | documentId/documentName |
| get_document_pages | Get document pages | documentId/documentName, pageIds |
| create_document_pages | Create a document page | workspaceId/documentId, parent_page_id/name/sub_title,content/content_format |
| update_document_page | Update a document page | workspaceId/documentId, name/sub_title,content/content_edit_mode/content_format |
See full documentation for optional parameters and advanced usage.
Not yet implemented and not supported by all client apps. Request a feature for a Prompt implementation that would be most beneficial for your workflow (without it being too specific). Examples:
| Prompt | Purpose | Features |
|---|---|---|
| summarize_tasks | Task overview | Status summary, priorities, relationships |
| analyze_priorities | Priority optimization | Distribution analysis, sequencing |
| generate_description | Task description creation | Objectives, criteria, dependencies |
The server provides clear error messages for:
The LOG_LEVEL environment variable can be specified to control the verbosity of server logs. Valid values are trace, debug, info, warn, and error (default).
This can be also be specified on the command line as, e.g. --env LOG_LEVEL=info.
When using this server, you may occasionally see a small sponsor message with a link to this repository included in tool responses. I hope you can support the project! If you find this project useful, please consider supporting:
Special thanks to ClickUp for their excellent API and services that make this integration possible.
Contributions are welcome! Please read our Contributing Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.
This software makes use of third-party APIs and may reference trademarks or brands owned by third parties. The use of such APIs or references does not imply any affiliation with or endorsement by the respective companies. All trademarks and brand names are the property of their respective owners. This project is an independent work and is not officially associated with or sponsored by any third-party company mentioned.
v0.8.0 (2025-06-12)
HTTP Streamable Transport Support:
ENABLE_SSE - Enable HTTP/SSE transport (default: false)PORT - HTTP server port (default: 3231)ENABLE_STDIO - Enable STDIO transport (default: true)/mcp - HTTP Streamable endpoint for MCP protocol communication/sse - Legacy SSE endpoint for backwards compatibilityMassive Codebase Refactor & Optimization:
Member Management Tools:
get_workspace_members - Retrieve all workspace members with detailsfind_member_by_name - Find specific members by name or emailresolve_assignees - Resolve user IDs/emails to assignee objectsassignees parameter for user assignmentassignees parameter for both single and bulk operationsFAQs
ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol
The npm package @rigo-m/clickup-mcp-server receives a total of 2 weekly downloads. As such, @rigo-m/clickup-mcp-server popularity was classified as not popular.
We found that @rigo-m/clickup-mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket Firewall Enterprise is now available with flexible deployment, configurable policies, and expanded language support.
Security News
Open source dashboard CNAPulse tracks CVE Numbering Authorities’ publishing activity, highlighting trends and transparency across the CVE ecosystem.
Product
Detect malware, unsafe data flows, and license issues in GitHub Actions with Socket’s new workflow scanning support.