# ClickUp (verified)

Project management and productivity platform. Create and manage tasks, track projects, collaborate with teams, and organize work across spaces and folders.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add clickup

# Browse available tools
npx -y @smithery/cli@latest tool list clickup

# Get full schema for a tool
npx -y @smithery/cli@latest tool get clickup clickup_search

# Call a tool
npx -y @smithery/cli@latest tool call clickup clickup_search '{}'
```

## Direct MCP Connection

Endpoint: `https://clickup.run.tools`

## Tools (51)

- `clickup_search` — Universal search across your entire ClickUp workspace. This is a powerful global search tool that finds ANY type of con…
- `clickup_get_workspace_hierarchy` — Get workspace hierarchy (spaces, folders, lists) from your authenticated workspace with pagination support. Workspace I…
- `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 cli…
- `clickup_get_task` — Get task details by task_id (works with regular/custom IDs). Set subtasks=true to include all subtask details.
- `clickup_filter_tasks` — Retrieve tasks with combined filters. Supports filtering by tags, lists, folders, spaces, statuses, assignees, due date…
- `clickup_update_task` — Update task properties. Requires task_id and at least one update field. Custom fields supported as array of {id, value}…
- `clickup_delete_task` — Delete a task from your Workspace by task_id. Works with regular and custom IDs (e.g. 'DEV-1234'). IMPORTANT: before ru…
- `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. Requ…
- `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 C…
- `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 remo…
- `clickup_get_task_comments` — Get task comments. Each comment includes reply_count indicating the number of threaded replies. Use clickup_get_threade…
- `clickup_create_task_comment` — Create task comment. Requires task_id and comment_text. Supports notify_all to alert assignees and assignee to assign t…
- `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…
- `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, st…
- `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…
- `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 …
- `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 requir…
- `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 …
- `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 t…
- `clickup_create_list` — Create a list in a ClickUp space efficiently. The system automatically detects workspace ID and resolves space names. U…
- `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 …
- `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 li…
- `clickup_update_list` — Update a ClickUp list. Requires list_id + at least one update field (name/content/status). Only specified fields update…
- `clickup_create_folder` — Create folder in ClickUp space. Use space_id (preferred) or space_name + folder name. Supports override_statuses for fo…
- `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 ot…
- `clickup_update_folder` — Update a ClickUp folder. Requires folder_id + at least one update field (name/override_statuses). Only specified fields…
- `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' …
- `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 - workspa…
- `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 us…
- `clickup_get_chat_channels` — Get chat channels in a workspace. Allows you to see available chat channels including their members, privacy settings, …
- `clickup_send_chat_message` — Send a message to a specific chat channel in the workspace. Messages can be either simple messages or posts with additi…
- `clickup_get_chat_channel_messages` — Get messages for a chat channel. Messages where has_replies=true have threaded replies fetchable via clickup_get_chat_m…
- `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 messa…
- `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 forma…
- `clickup_search_reminders` — Search and list reminders in your ClickUp workspace. Returns reminders for the authenticated user with various filterin…
- `clickup_update_reminder` — Update an existing reminder in your ClickUp workspace. Requires the reminder_id. All other fields are optional - only p…
- `clickup_get_custom_fields` — Get custom field definitions at any hierarchy level (list, folder, space, or workspace). Returns field IDs, types, and …
- `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 c…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get clickup <tool-name>
```
