ClickUp
Manage projects, tasks, and documents directly through a comprehensive suite of productivity tools.
Community: Submitted by a user or imported; check the owner before granting accessDegradedAPI key requiredGlobalFreeRead-only
What it can do
- Ping: Echo request for connectivity checks.
- Health: Report server readiness and enforced safety limits.
- Tool Catalogue: Enumerate all available tools with their annotations.
What data it sees
Do you need an account
An API key from the service settings is required
Manage projects, tasks, and documents directly through a comprehensive suite of productivity tools. Search for tasks, generate status reports, and track time entries across entire workspaces. Access document hierarchies and member information to streamline collaboration and project oversight.
Server tool list (41)
Raw names from tools/list. Only developers need these.
| ping | Echo request for connectivity checks. |
| health | Report server readiness and enforced safety limits. |
| tool_catalogue | Enumerate all available tools with their annotations. |
| workspace_capability_snapshot | Expose cached ClickUp capability probes for this session. |
| workspace_list | List accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces. |
| space_list_for_workspace | List spaces for a workspace by workspaceId. Use search when you only know workspace names. |
| folder_list_for_space | List folders within a ClickUp space. Use when you already know spaceId. |
| list_list_for_space_or_folder | List lists inside a space or folder by ID. If you only know names, resolve them first with resolve_path_to_ids. |
| workspace_overview | Summarise workspace metrics and recent spaces/folders/lists when you have a workspaceId. |
| workspace_hierarchy | Fetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure without task data. |
| hierarchy_resolve_path | Resolve workspace/space/folder/list names into IDs. Use before tools that require IDs. |
| member_list_for_workspace | List members in a workspace by teamId. Use when you already know the workspaceId. |
| member_resolve | Resolve member identifiers (id, email, username) into member records for a workspace. |
| member_search_by_name | Fuzzy search member names to find member IDs. |
| task_assignee_resolve | Translate assignee references into suggested member IDs for tasks. |
| space_tag_list | List tags configured for a space using spaceId. |
| reference_link_list | List public ClickUp API reference links. |
| reference_page_fetch | Fetch a public ClickUp API reference page from a link returned by reference_link_list. |
| task_search | Structured task search with filters. Use when you have listIds/tagIds; returns tasks across lists. |
| task_search_fuzzy | Fuzzy task search from natural language when you do not have precise filters. |
| task_search_fuzzy_bulk | Batch fuzzy task searches for multiple natural language prompts. |
| task_status_report | Summarise task status and priority for a workspace, space, folder or list without returning full task lists. |
| task_risk_report | Summarise overdue and at-risk tasks within a workspace, space, folder or list. Subtasks are included by default; use includeSubtasks to focus on parent tasks and inspect isSubtask/parentId in results to understand hierarchy. |
| task_read | Fetch task details including createdDate/updatedDate fields derived from ClickUp timestamps. Subtask cues (isSubtask, parentId, hasSubtasks, subtaskCount) are included; check them before claiming there are no subtasks. GET /task/{task_id} |
| task_list_for_list | List tasks in a list. Tasks linked from other lists are included by default (include_timl=true). Outputs include createdDate derived from ClickUp date_created and hierarchy cues (isSubtask, parentId, hasSubtasks, subtaskCount). Always review hasSubtasks/subtaskCount before asserting there are no subtasks. Results are paginated and may span multiple pages; iterate via the page input to retrieve additional pages. GET /list/{list_id}/task |
| task_comment_list | Retrieve task comments for a taskId. |
| list_custom_field_list | List custom fields configured for a list by listId. |
| doc_list | List documents within a workspace using filters. |
| doc_read | Fetch document metadata and pages for a docId. |
| doc_pages_read | Fetch selected document pages by docId and pageIds. |
| doc_page_list | List page hierarchy for a document by docId. |
| doc_page_read | Fetch a single document page by docId and pageId. |
| doc_search | Search document content across a workspace. Use doc_page_read for specific pages. |
| doc_search_bulk | Batch document searches when you need several queries processed together. |
| task_time_entry_list | Fetch time entries for a taskId, including total duration. |
| time_entry_current | Retrieve the current running timer for the workspace. |
| time_entry_list | List time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a single task. |
| time_report_for_tag | Aggregate logged time for a tag across the workspace. Use space_tag_list to discover tags, and includeSubtasks to control whether child task time is counted. |
| time_report_for_container | Aggregate time for a workspace, space, folder or list using containerId + containerType. Resolve IDs with resolve_path_to_ids, list_workspaces/spaces/folders/lists, and set includeSubtasks to clarify hierarchy handling. |
| time_report_for_context | Aggregate time for a task, list (including filtered views), space or workspace. Use search_tasks or task_list_for_list to source listId/taskId before calling. Subtask handling is explicit via includeSubtasks. |
| time_report_for_space_tag | Aggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtasks to control hierarchy. |