ClickUp
Project management and productivity platform.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeCan modify data
What it can do
- Clickup Search: Universal search across your entire ClickUp workspace. This is a powerful global search tool that finds ANY type of content - tasks, documents, dashboards, attachments, whiteboards, ch
- Clickup Get Workspace Hierarchy: Get workspace hierarchy (spaces, folders, lists) from your authenticated workspace with pagination support. Workspace ID is automatically detected from your session. R
- Clickup Create Task: Create task in a ClickUp list. Requires task name and list_id. ALWAYS ask user which list to use - never guess. Use clickup_get_list to resolve list names to IDs. Supports assigne
What data it sees
Do you need an account
No: the server works without sign-in
Project management and productivity platform. Create and manage tasks, track projects, collaborate with teams, and organize work across spaces and folders.
How to connect
How to connect ClickUp to Claude
The server address to paste into Claude settings:
https://clickup.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect ClickUp to ChatGPT
The server address to paste into ChatGPT settings:
https://clickup.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect ClickUp to Cursor
The server address to paste into Cursor settings:
https://clickup.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (51)
Raw names from tools/list. Only developers need these.
| clickup_search | Universal search across your entire ClickUp workspace. This is a powerful global search tool that finds ANY type of content - tasks, documents, dashboards, attachments, whiteboards, chat messages, and forms. Use this tool when: - You need to find something but don't know exactly where it is or what type it is - You want to search across multiple asset types at once - You're looking for items by keyword, content, or partial name matches - You need to find all items assigned to specific users or created by certain people - You want to search within specific spaces, folders, or lists - You need to filter by creation date or due date ranges - You need results sorted by creation or update time This tool searches EVERYTHING - it looks inside task names, descriptions, document content, chat messages, file names, and more. Results include highlighted matches and full hierarchy (Space > Folder > List) for context. Supports advanced filtering by assignees, creators, status, location, asset types, and date ranges (creation date and due date). Date filters accept dates in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format, and use your user timezone. Returns paginated results with a cursor for fetching additional pages. The results are intelligently formatted for optimal readability, providing a concise overview and structured data for each result. Note: For specific operations on known items (like updating a task you already identified), use the dedicated tools instead. |
| clickup_get_workspace_hierarchy | Get workspace hierarchy (spaces, folders, lists) from your authenticated workspace with pagination support. Workspace ID is automatically detected from your session. Returns tree structure with names and IDs for navigation. Supports pagination for large workspaces and depth control to fetch only needed levels. Note: Use this ONLY when you need to see the workspace structure - most tools can resolve names automatically without this lookup. |
| clickup_create_task | Create task in a ClickUp list. Requires task name and list_id. ALWAYS ask user which list to use - never guess. Use clickup_get_list to resolve list names to IDs. Supports assignees as array of user IDs, emails, usernames, or "me". Supports task_type to specify the task type by name (e.g., 'Bug', 'Feature'). |
| clickup_get_task | Get task details by task_id (works with regular/custom IDs). Set subtasks=true to include all subtask details. Response Size Optimization: - Use detail_level='summary' for lightweight responses when full details aren't needed - Responses exceeding 50,000 tokens automatically switch to summary format to prevent client issues - Summary format includes essential fields: id, name, status, description (truncated), assignees, tags, due_date, url |
| clickup_filter_tasks | Retrieve tasks with combined filters. Supports filtering by tags, lists, folders, spaces, statuses, assignees, due date range, and completion date range. Within each filter type, multiple values use OR logic (e.g., tags: ["bug", "feature"] returns tasks with either tag). Across filter types, AND logic applies (e.g., tags: ["bug"] + list_ids: ["123"] returns only "bug"-tagged tasks in list 123). Use this tool when you need to find tasks by tag (e.g., "bug"), list multiple tasks matching criteria, or combine multiple filters. Use date_done_from/date_done_to with include_closed to find completed tasks in a date range. For single task by ID, use clickup_get_task instead. Assignees must be numeric user IDs — use clickup_resolve_assignees to convert names/emails/"me" first. |
| clickup_update_task | Update task properties. Requires task_id and at least one update field. Custom fields supported as array of {id, value}. Supports assignees as array of user IDs, emails, usernames, or "me". Supports task_type to change the task type by name (e.g., 'Bug', 'Feature'), or null to reset to default. |
| clickup_delete_task | Delete a task from your Workspace by task_id. Works with regular and custom IDs (e.g. 'DEV-1234'). IMPORTANT: before running this tool, ALWAYS confirm with the user the correct task_id to delete. |
| clickup_move_task | Move a task to a new home list. The task is removed from its current home list and placed in the destination list. Requires task_id and list_id. Works with regular and custom task IDs (e.g. 'DEV-1234'). Use clickup_get_list to resolve list names to IDs. |
| clickup_add_task_to_list | Add a task to an additional list without removing it from its current home list. Requires the Tasks in Multiple Lists ClickApp to be enabled. Requires task_id and list_id. Use clickup_get_list to resolve list names to IDs. |
| clickup_remove_task_from_list | Remove a task from an additional list. The task remains in its home list and any other lists it belongs to. Cannot remove a task from its home list. Requires the Tasks in Multiple Lists ClickApp to be enabled. Requires task_id and list_id. |
| clickup_get_task_comments | Get task comments. Each comment includes reply_count indicating the number of threaded replies. Use clickup_get_threaded_comments to fetch replies for comments with reply_count > 0. Use start/start_id params for pagination. |
| clickup_create_task_comment | Create task comment. Requires task_id and comment_text. Supports notify_all to alert assignees and assignee to assign the comment. |
| clickup_get_threaded_comments | Get threaded replies for a comment. Use clickup_get_task_comments first to find comments with reply_count > 0, then use this tool with the comment_id to fetch the thread replies. |
| clickup_attach_task_file | Attach file to task. Requires task_id. File sources: 1) base64 + filename, 2) URL (http/https). |
| clickup_get_task_time_entries | Get all time entries for a task with filtering options. Returns all tracked time with user info, descriptions, tags, start/end times, and durations. |
| clickup_start_time_tracking | Start time tracking on a task. Supports description, billable status, and tags. Only one timer can be running at a time. For best results, omit extra parameters unless specifically needed. |
| clickup_stop_time_tracking | Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details. |
| clickup_add_time_entry | Add a manual time entry to a task. You can provide either (start + duration) OR (start + end). The tool will calculate missing values. Requires task_id, start time, and either duration or end time. Supports description, billable flag, and tags. |
| clickup_get_current_time_entry | Get the currently running time entry, if any. No parameters needed. |
| clickup_get_time_entries | Get time entries across all tasks within a date range for reporting purposes. Unlike get_task_time_entries which requires a task_id, this tool queries the entire workspace and is ideal for generating time tracking reports (e.g., 'how much time was tracked last month', 'billable hours this week'). |
| clickup_get_task_time_in_status | Get the time a task has spent in each status. Returns the current status with elapsed time and the full status history with time spent in each status. Requires the "Total time in Status" ClickApp to be enabled in the workspace. |
| clickup_get_bulk_tasks_time_in_status | Get the time multiple tasks have spent in each status (bulk operation, up to 100 tasks). Returns a map of task IDs to their status history and current status time data. Requires the "Total time in Status" ClickApp to be enabled in the workspace. |
| clickup_create_list | Create a list in a ClickUp space efficiently. The system automatically detects workspace ID and resolves space names. Use space_name (preferred for simplicity) or space_id + list name. Name is required. For lists in folders, use clickup_create_list_in_folder. Supports content, due_date, priority, assignee, and status. Note: No need to look up workspace hierarchy or space IDs first - the system handles space name resolution automatically. |
| clickup_create_list_in_folder | Create a list in a ClickUp folder. Requires folder_id and list name. Supports content and status. If you need to get a folder ID from a folder name, use clickup_get_folder first. |
| clickup_get_list | Get details of a ClickUp list by ID or name. Use this tool to lookup a list ID from a list name before calling other list operations. Returns list details including id, name, content, and space info. Accepts either list_id or list_name. |
| clickup_update_list | Update a ClickUp list. Requires list_id + at least one update field (name/content/status). Only specified fields updated. If you need to get a list ID from a list name, use clickup_get_list first. |
| clickup_create_folder | Create folder in ClickUp space. Use space_id (preferred) or space_name + folder name. Supports override_statuses for folder-specific statuses. Use clickup_create_list_in_folder to add lists after creation. |
| clickup_get_folder | Get details of a ClickUp folder by ID or name. Use this tool to lookup a folder ID from a folder name before calling other folder operations. Returns folder details including id, name, and space info. Accepts either folder_id or folder_name + space info. |
| clickup_update_folder | Update a ClickUp folder. Requires folder_id + at least one update field (name/override_statuses). Only specified fields updated. Changes apply to all lists in folder. If you need to get a folder ID from a folder name, use clickup_get_folder first. |
| clickup_add_tag_to_task | Add existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist. |
| clickup_remove_tag_from_task | Remove tag from task. Only removes tag-task association, tag remains in space. |
| clickup_add_task_dependency | Set a dependency between two tasks. Use 'waiting_on' when task_id cannot start until depends_on is done, or 'blocking' when task_id is blocking depends_on. |
| clickup_remove_task_dependency | Remove a dependency between two tasks. |
| clickup_add_task_link | Link two tasks together. Creates a bidirectional relationship between the tasks. |
| clickup_remove_task_link | Remove a link between two tasks. |
| clickup_get_workspace_members | Get all members (users) in the ClickUp workspace/team from your authenticated workspace. No parameters needed - workspace ID is automatically detected. Note: Most tools automatically resolve assignees by name or email without needing this lookup first. Use this ONLY when you need to see all available members. |
| clickup_find_member_by_name | Get a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found. |
| clickup_resolve_assignees | Resolve an array of assignee names, emails, or "me" to ClickUp user IDs. Use "me" to get the currently authenticated user's ID. Returns an array of user IDs, or null for any that cannot be resolved. Note: Most task tools automatically resolve assignees - use this only when you need the user IDs separately (e.g., for search filters). |
| clickup_get_chat_channels | Get chat channels in a workspace. Allows you to see available chat channels including their members, privacy settings, and creation details. Supports pagination using the cursor parameter. |
| clickup_send_chat_message | Send a message to a specific chat channel in the workspace. Messages can be either simple messages or posts with additional metadata. |
| clickup_get_chat_channel_messages | Get messages for a chat channel. Messages where has_replies=true have threaded replies fetchable via clickup_get_chat_message_replies. If you don't have the channel_id, use clickup_get_chat_channels first. Supports pagination. |
| clickup_get_chat_message_replies | Get threaded replies for a chat message. Only messages where has_replies=true have replies. If you don't have the message_id, use clickup_get_chat_channel_messages first. Supports pagination. |
| clickup_create_reminder | Create a personal reminder in your ClickUp workspace. Requires title and due_date (YYYY-MM-DD or YYYY-MM-DD HH:MM format, uses your timezone). |
| clickup_search_reminders | Search and list reminders in your ClickUp workspace. Returns reminders for the authenticated user with various filtering options. Use this tool when you need to: - Find all your upcoming or overdue reminders - Check reminder status and due dates - Filter reminders by type (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER) - Filter reminders by status (TODO, LATER, DELETED) - Filter reminders by completion status - List reminders updated after a specific date The since filter accepts dates in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format, and uses your user timezone. Supports pagination using the cursor parameter for large result sets. |
| clickup_update_reminder | Update an existing reminder in your ClickUp workspace. Requires the reminder_id. All other fields are optional - only provide the fields you want to update. Use this tool to: - Change the title or description of a reminder - Update the due date (in YYYY-MM-DD or YYYY-MM-DD HH:MM format, uses your timezone) - Mark a reminder as completed or incomplete |
| clickup_get_custom_fields | Get custom field definitions at any hierarchy level (list, folder, space, or workspace). Returns field IDs, types, and options for dropdowns/labels. Use this to discover available custom fields before setting values on tasks. Multiple scopes can be queried in a single call. |
| clickup_create_document | Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag. |
| clickup_list_document_pages | Get all pages in a document with optional depth control. |
| clickup_get_document_pages | Get the content of specific pages from a document. |
| clickup_create_document_page | Create a new page in a ClickUp document. |
| clickup_update_document_page | Update an existing page in a ClickUp document. WARNING: When content is provided, it fully REPLACES the existing page content. To preserve existing content, first read the page, then include the original content along with your changes. |